Raw schema
{
"type": "object",
"properties": {
"text": {
"description": "The post body. Per-platform limits apply; see variants to differ by platform. Leave it out when publishing an existing draft by postId: the draft already has its words.",
"type": "string"
},
"postId": {
"description": "A draft to publish, by its id or by the number shown to the user (#1). Its text, pictures and per-platform wording are used unless you pass your own.",
"type": "string"
},
"destinations": {
"description": "Where to publish. Leave it out when publishing a draft by postId: it goes to the connected account for each platform the draft was written for.",
"type": "array",
"items": {
"type": "object",
"required": [
"accountId"
],
"properties": {
"accountId": {
"description": "Connected account id from list_accounts.",
"type": "string"
},
"subaccountId": {
"description": "Page or organization id from list_subaccounts.",
"type": "string"
},
"target": {
"type": "object",
"properties": {
"pageId": {
"description": "Facebook page or LinkedIn organization to post as.",
"type": "string"
},
"mediaType": {
"description": "reel or story, for Instagram and Facebook video.",
"type": "string"
},
"altText": {
"description": "Accessibility description for the image. Not supported for Instagram Reels; ignored for Instagram video posts.",
"type": "string"
},
"firstComment": {
"description": "Posted as a comment once the post is live.",
"type": "string"
},
"link": {
"description": "Link preview, Facebook only.",
"type": "string"
},
"title": {
"description": "Required by YouTube (at most 100 characters, no < or >); optional title for TikTok photos.",
"type": "string"
},
"privacyStatus": {
"description": "YouTube only, and required: who can watch it. The user chooses it; ask them, never pick one yourself.",
"anyOf": [
{
"const": "public",
"type": "string"
},
{
"const": "unlisted",
"type": "string"
},
{
"const": "private",
"type": "string"
}
]
},
"isMadeForKids": {
"description": "YouTube only, and required by law: whether the video is made for kids. Ask the user; never assume.",
"type": "boolean"
},
"containsSyntheticMedia": {
"description": "YouTube only: realistic AI-generated or altered content. Set from the media when left out.",
"type": "boolean"
},
"shouldNotifySubscribers": {
"description": "YouTube only: tell the channel's subscribers. Default yes.",
"type": "boolean"
},
"privacyLevel": {
"description": "TikTok only, and required: who can see it, one of the options get_tiktok_settings lists for the account. The user chooses it; ask them, never pick one yourself.",
"type": "string"
},
"disabledComments": {
"description": "TikTok only.",
"type": "boolean"
},
"disabledDuet": {
"description": "TikTok only.",
"type": "boolean"
},
"disabledStitch": {
"description": "TikTok only.",
"type": "boolean"
},
"isBrandedContent": {
"description": "TikTok only: paid partnership.",
"type": "boolean"
},
"isYourBrand": {
"description": "TikTok only: promoting your own brand.",
"type": "boolean"
},
"isAiGenerated": {
"description": "TikTok only: AI-generated content disclosure.",
"type": "boolean"
},
"shareToFeed": {
"description": "Instagram reels: also show in the feed.",
"type": "boolean"
},
"collaborators": {
"description": "Instagram handles to invite, up to three.",
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}
},
"mediaIds": {
"description": "Media ids from an upload tool.",
"type": "array",
"items": {
"type": "string"
}
},
"thread": {
"description": "Continuations, posted as replies to the first one. X and Threads only; other platforms ignore them.",
"type": "array",
"items": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"mediaIds": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"variants": {
"description": "Per-platform overrides, keyed by platform name.",
"type": "object",
"patternProperties": {
"^(.*)$": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"mediaIds": {
"type": "array",
"items": {
"type": "string"
}
},
"thread": {
"type": "array",
"items": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"mediaIds": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}
}
}
},
"scheduledTime": {
"description": "ISO 8601 instant to publish at.",
"type": "string"
},
"useNextFreeSlot": {
"description": "Take the next free opening in the calendar.",
"type": "boolean"
},
"title": {
"description": "Internal title, never published.",
"type": "string"
},
"platformTargets": {
"description": "Settings per platform, keyed by platform, applied to that platform's destination - also when publishing a draft by postId. TikTok needs privacyLevel chosen by the user (read the options with get_tiktok_settings, ask, never pick one yourself), and the interaction and commercial-content choices they made. YouTube needs a title, privacyStatus and isMadeForKids, all asked of the user (get_youtube_settings shows the channel); the video must be vertical or square and at most 3 minutes, which makes it a Short.",
"type": "object",
"patternProperties": {
"^(.*)$": {
"type": "object",
"properties": {
"pageId": {
"description": "Facebook page or LinkedIn organization to post as.",
"type": "string"
},
"mediaType": {
"description": "reel or story, for Instagram and Facebook video.",
"type": "string"
},
"altText": {
"description": "Accessibility description for the image. Not supported for Instagram Reels; ignored for Instagram video posts.",
"type": "string"
},
"firstComment": {
"description": "Posted as a comment once the post is live.",
"type": "string"
},
"link": {
"description": "Link preview, Facebook only.",
"type": "string"
},
"title": {
"description": "Required by YouTube (at most 100 characters, no < or >); optional title for TikTok photos.",
"type": "string"
},
"privacyStatus": {
"description": "YouTube only, and required: who can watch it. The user chooses it; ask them, never pick one yourself.",
"anyOf": [
{
"const": "public",
"type": "string"
},
{
"const": "unlisted",
"type": "string"
},
{
"const": "private",
"type": "string"
}
]
},
"isMadeForKids": {
"description": "YouTube only, and required by law: whether the video is made for kids. Ask the user; never assume.",
"type": "boolean"
},
"containsSyntheticMedia": {
"description": "YouTube only: realistic AI-generated or altered content. Set from the media when left out.",
"type": "boolean"
},
"shouldNotifySubscribers": {
"description": "YouTube only: tell the channel's subscribers. Default yes.",
"type": "boolean"
},
"privacyLevel": {
"description": "TikTok only, and required: who can see it, one of the options get_tiktok_settings lists for the account. The user chooses it; ask them, never pick one yourself.",
"type": "string"
},
"disabledComments": {
"description": "TikTok only.",
"type": "boolean"
},
"disabledDuet": {
"description": "TikTok only.",
"type": "boolean"
},
"disabledStitch": {
"description": "TikTok only.",
"type": "boolean"
},
"isBrandedContent": {
"description": "TikTok only: paid partnership.",
"type": "boolean"
},
"isYourBrand": {
"description": "TikTok only: promoting your own brand.",
"type": "boolean"
},
"isAiGenerated": {
"description": "TikTok only: AI-generated content disclosure.",
"type": "boolean"
},
"shareToFeed": {
"description": "Instagram reels: also show in the feed.",
"type": "boolean"
},
"collaborators": {
"description": "Instagram handles to invite, up to three.",
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}
}
}