Schemas

Total number of items

Items per page

Number of items skipped

Whether there are more items

Post ID

Post type

Post content per platform

Account IDs to post to

Per-platform media object. Keys: default, instagram, facebook, etc. Each value is an array of {url, id, channel}.

Scheduled publish time (ISO 8601)

URLs where post was published (per platform)

Approval workflow status (if applicable)

Platform-specific error details (when status is failed or warning)

Post content. Use 'default' for all platforms, or platform-specific keys: instagram, facebook, linkedin, youtube, tiktok, pinterest, x, threads, bluesky, mastodon. Coming soon: google_business, reddit, snapchat.

Social account IDs to post to. Get IDs from GET /accounts

Post type: 'post' (feed), 'story' (Instagram/Facebook), 'reel' (Instagram/Facebook/YouTube/TikTok)

Media IDs from POST /media/upload. Flat array or per-platform object.

External image/video URLs to download and attach (max 10 total). Flat array or per-platform object. When using per-platform format, 'default' acts as fallback for selected platforms without their own key.

ISO 8601 datetime to schedule. Omit for draft.

Set true to publish immediately

Pinterest-specific options

YouTube Shorts options

Instagram Reel options

TikTok options

X (Twitter) options

Media ID (use this in post creation)

CDN URL for the media

File size in bytes

Account ID (use this when creating posts)

Social media username/handle

Display name on the platform

Profile picture URL

Supported content types for this platform

Connection status. Only connected (active) accounts are returned.

Pinterest boards (only present for Pinterest accounts). Use board id as board_id when creating Pinterest posts.

Platform-specific details. Present for X accounts with Premium subscription.

Engagement rate as a percentage (0-100)

Platform-specific account metrics (followers, impressions, profile_views, etc.)

URL to receive webhook events

Events to subscribe to

Consecutive delivery failures

Event ID

Event type (e.g., post.published)

Event-specific data