PostInput
versions object[]required
At least one version with is_original: true is required.
Possible values: >= 1
Use 0 for the original/default version.
Must be true for the first version.
Account ID of the version this version follows (0 = the original), or null when it is edited independently. Ignored on the original version.
Possible values: >= 0
content object[]required
Ordered content items. Item 0 is the post. Item 1 is the first comment on
Facebook Page, Instagram and LinkedIn (LinkedIn only when first comments are enabled
on this server), or the next thread post on X, Threads, Bluesky, Mastodon and
Pixelfed. See PostContent.
Possible values: >= 1
Post text/caption. For a second item on Facebook Page, Instagram or LinkedIn this is the first comment.
Link shown as a preview card on LinkedIn, Bluesky and Facebook Pages (Facebook builds the card from the page's own Open Graph tags). If omitted and the item has no media, the first link in body is used.
Array of media IDs from the media library.
options object
Platform-specific publishing options, keyed by network (tiktok, youtube, instagram,
mastodon, …). Options of networks the post does not publish to are ignored. To label a post
as AI-generated on every network that supports it, send ai_generated on the post instead
of setting tiktok.is_aigc, youtube.contains_synthetic_media or instagram.ai_generated
yourself.
tiktok object
TikTok options. Every field is a map of account-<account id> to a value, so one post can carry
different settings for several TikTok accounts.
privacy_level object
is_aigc object
TikTok's "AI-generated content" label.
allow_comments object
allow_duet object
allow_stitch object
auto_add_music object
content_disclosure object
Discloses branded or promotional content; then set brand_organic_toggle and/or brand_content_toggle.
brand_organic_toggle object
brand_content_toggle object
youtube object
YouTube options. The video title is required.
Possible values: <= 100 characters
Possible values: [public, private, unlisted]
publicfalseYouTube's "altered or synthetic content" disclosure. Set by ai_generated.
falseinstagram object
Instagram options (instagram for accounts connected through Facebook, instagram_standalone for Instagram Login).
Possible values: [post, reel, story]
postUsernames invited as collaborators (not for stories).
Possible values: <= 3
Instagram's "AI info" label on the post (on the carousel itself for carousels; not for stories). Set by ai_generated.
falseinstagram_standalone object
Instagram options (instagram for accounts connected through Facebook, instagram_standalone for Instagram Login).
Possible values: [post, reel, story]
postUsernames invited as collaborators (not for stories).
Possible values: <= 3
Instagram's "AI info" label on the post (on the carousel itself for carousels; not for stories). Set by ai_generated.
falsePlatform-specific publishing options, keyed by network (tiktok, youtube, instagram,
mastodon, …). Options of networks the post does not publish to are ignored. To label a post
as AI-generated on every network that supports it, send ai_generated on the post instead
of setting tiktok.is_aigc, youtube.contains_synthetic_media or instagram.ai_generated
yourself.
Account IDs to publish to.
Tag IDs to attach.
2025-06-0110:00Timezone date, time and accounts_schedule are read in. Defaults to the workspace timezone.
America/New_Yorkaccounts_schedule object[]
Per-account departure times. When omitted on update, accounts keep their offsets from the post time.
ID of one of the post's accounts. Entries for accounts the post does not carry are ignored.
2026-11-01H:i, read in the request timezone. Must not be in the past.
14:30Schedule the post for the given date/time.
Publish immediately.
Add to the smart publishing queue.
Declares the post AI-generated (or, with false, not). PostBoost sets each network's own AI
label: TikTok's is_aigc for every TikTok account in accounts, Instagram's "AI info" label
(instagram.ai_generated) and YouTube's synthetic-media disclosure
(youtube.contains_synthetic_media). The other networks have no API label. The response
carries X-AI-Disclosure: applied when every network with a label got it. When omitted, a
post that attaches images made by the AI image endpoints is labelled automatically. See the
AI disclosure guide.
Skip the duplicate guard. By default the API refuses (409, code: duplicate_post) content that
matches a post created for the same account in the last 24 hours. The header
X-Allow-Duplicate: true does the same.
false{
"versions": [
{
"account_id": 0,
"is_original": true,
"synced_with": 0,
"content": [
{
"body": "string",
"url": "string",
"media": [
0
],
"video_thumbs": [
{}
]
}
],
"options": {
"tiktok": {
"privacy_level": {
"account-12": "PUBLIC_TO_EVERYONE"
},
"is_aigc": {
"account-12": true
},
"allow_comments": {},
"allow_duet": {},
"allow_stitch": {},
"auto_add_music": {},
"content_disclosure": {},
"brand_organic_toggle": {},
"brand_content_toggle": {}
},
"youtube": {
"title": "string",
"status": "public",
"made_for_kids": false,
"contains_synthetic_media": false
},
"instagram": {
"type": "post",
"collaborators": [
"string"
],
"ai_generated": false
},
"instagram_standalone": {
"type": "post",
"collaborators": [
"string"
],
"ai_generated": false
}
}
}
],
"accounts": [
0
],
"tags": [
0
],
"date": "2025-06-01",
"time": "10:00",
"timezone": "America/New_York",
"accounts_schedule": [
{
"account_id": 0,
"date": "2026-11-01",
"time": "14:30"
}
],
"schedule": true,
"schedule_now": true,
"queue": true,
"ai_generated": true,
"allow_duplicate": false
}