Social object
Social
The social object is returned by the socials endpoints and shares the same id and platform semantics used in post account payloads.
The id and platform values returned by /socials match the objects used in Post.accounts. You can pass those IDs directly when creating or updating posts.
| Field | Type | Description |
|---|---|---|
| id | string | Social account identifier. Matches Post.accounts[].id. |
| platform | string | Platform name. Matches Post.accounts[].platform. |
| display_name | string | Display name for the connected social profile. |
| handle | string | null | Handle or username when available. |
| avatar_url | string | null | Avatar image URL when available. |
| status | active | failed | Current account status in the public API context. |
| error_message | string | null | User-facing failure reason when status is failed. Otherwise null. |