OpenAPI 3.1.02026-08-14670122.4 KB

86a99db1a33d

Social

Publish to Social

Publish images or videos directly to connected social accounts

post/social/publish

Request body

contentstring

Caption/text for the post (max 5000 characters)

media_urlstring

URL of the image or video to publish

statusstring

published (default), draft or scheduled — see above

scheduled_forstring

ISO 8601 timestamp, at least 60 seconds ahead. Required with status: "scheduled", invalid otherwise

timezonestring

IANA timezone string for scheduling (e.g., "America/New_York", "Europe/London")

platformOptionsobject

Per-account options keyed by account ID (see below). platform_options also accepted

tiktokSettingsobject

Root-level TikTok options. For photo carousels, { "autoAddMusic": true } asks TikTok to add recommended music.

Response

Successful response

object required