postproxy-dev · Schema

Profile

A connected social media account.

Social MediaSoftware-as-a-ServiceMarketingAutomation

Properties

Name Type Description
id string Unique profile identifier (id).
name string Display name of the connected account.
username stringnull Handle on the platform (without @). null when the platform does not expose one.
platform_id string The account's ID on the platform.
status string Platform connection status. inactive might mean disconnected or suspended on a platform, or waiting for a group that can take it - see inactive_reason.
inactive_reason stringnull Why an inactive profile is inactive. network_taken: the account arrived with a Facebook login that granted several Instagram accounts, but its group already holds an active Instagram profile - move it
platform string Platform identifier.
profile_group_id string ID of the profile group this belongs to.
expires_at stringnull ISO 8601 timestamp when the connection expires (if applicable). null when the token does not expire or has a refresh token.
post_count integer Number of posts made through this profile.
avatar_url stringnull Stable Postproxy storage URL of the account's profile picture, resized to 256x256. null until it has been mirrored. For facebook this is the connecting user's picture; each Page's picture is avatar_ur
platform_url stringnull Public URL of the account on the platform. null when the platform has no stable public profile URL (e.g. linkedin, google_business).
placements_sync_status stringnull State of the latest pull of this profile's placements. The pull runs in the background right after connecting and can take several minutes on profiles with many pages/locations. null for platforms wit
View JSON Schema on GitHub

JSON Schema

postproxy-dev-profile-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/postproxy-dev/json-schema/postproxy-dev-profile-schema.json",
  "title": "Profile",
  "description": "A connected social media account.",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/postproxy-dev-openapi.json#/components/schemas/Profile",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique profile identifier (id)."
    },
    "name": {
      "type": "string",
      "description": "Display name of the connected account."
    },
    "username": {
      "type": [
        "string",
        "null"
      ],
      "description": "Handle on the platform (without @). null when the platform does not expose one."
    },
    "platform_id": {
      "type": "string",
      "description": "The account's ID on the platform."
    },
    "status": {
      "type": "string",
      "description": "Platform connection status. inactive might mean disconnected or suspended on a platform, or waiting for a group that can take it - see inactive_reason.",
      "enum": [
        "active",
        "expired",
        "inactive"
      ]
    },
    "inactive_reason": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "network_taken",
        null
      ],
      "description": "Why an inactive profile is inactive. network_taken: the account arrived with a Facebook login that granted several Instagram accounts, but its group already holds an active Instagram profile - move it to a group without one to activate it. null otherwise, including when the connection was lost and needs reconnecting."
    },
    "platform": {
      "type": "string",
      "description": "Platform identifier.",
      "enum": [
        "facebook",
        "instagram",
        "tiktok",
        "linkedin",
        "youtube",
        "twitter",
        "threads",
        "pinterest",
        "bluesky",
        "telegram",
        "google_business"
      ]
    },
    "profile_group_id": {
      "type": "string",
      "description": "ID of the profile group this belongs to."
    },
    "expires_at": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO 8601 timestamp when the connection expires (if applicable). null when the token does not expire or has a refresh token."
    },
    "post_count": {
      "type": "integer",
      "description": "Number of posts made through this profile."
    },
    "avatar_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "Stable Postproxy storage URL of the account's profile picture, resized to 256x256. null until it has been mirrored. For facebook this is the connecting user's picture; each Page's picture is avatar_url on its placement."
    },
    "platform_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "Public URL of the account on the platform. null when the platform has no stable public profile URL (e.g. linkedin, google_business)."
    },
    "placements_sync_status": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "syncing",
        "synced",
        "failed",
        null
      ],
      "description": "State of the latest pull of this profile's placements. The pull runs in the background right after connecting and can take several minutes on profiles with many pages/locations. null for platforms without placements and for telegram, whose channels arrive via webhook."
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/postproxy-dev-profile"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.