Skip to main content

PostInput

versions object[]required

At least one version with is_original: true is required.

Possible values: >= 1

  • Array [
  • account_idintegerrequired

    Use 0 for the original/default version.

    is_originalbooleanrequired

    Must be true for the first version.

    synced_withinteger | nullnullable

    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

  • Array [
  • bodystring | nullnullable

    Post text/caption. For a second item on Facebook Page, Instagram or LinkedIn this is the first comment.

    url(string | null)<uri>nullable

    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.

    mediainteger[]

    Array of media IDs from the media library.

    video_thumbsobject[]
  • ]
  • 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.

    property name*boolean
    allow_comments object
    property name*boolean
    allow_duet object
    property name*boolean
    allow_stitch object
    property name*boolean
    auto_add_music object
    property name*boolean
    content_disclosure object

    Discloses branded or promotional content; then set brand_organic_toggle and/or brand_content_toggle.

    property name*boolean
    brand_organic_toggle object
    property name*boolean
    brand_content_toggle object
    property name*boolean
    youtube object

    YouTube options. The video title is required.

    titlestring

    Possible values: <= 100 characters

    statusstring

    Possible values: [public, private, unlisted]

    Default value: public
    made_for_kidsboolean
    Default value: false
    contains_synthetic_mediaboolean

    YouTube's "altered or synthetic content" disclosure. Set by ai_generated.

    Default value: false
    instagram object

    Instagram options (instagram for accounts connected through Facebook, instagram_standalone for Instagram Login).

    typestring

    Possible values: [post, reel, story]

    Default value: post
    collaboratorsstring[]

    Usernames invited as collaborators (not for stories).

    Possible values: <= 3

    ai_generatedboolean

    Instagram's "AI info" label on the post (on the carousel itself for carousels; not for stories). Set by ai_generated.

    Default value: false
    instagram_standalone object

    Instagram options (instagram for accounts connected through Facebook, instagram_standalone for Instagram Login).

    typestring

    Possible values: [post, reel, story]

    Default value: post
    collaboratorsstring[]

    Usernames invited as collaborators (not for stories).

    Possible values: <= 3

    ai_generatedboolean

    Instagram's "AI info" label on the post (on the carousel itself for carousels; not for stories). Set by ai_generated.

    Default value: false
    property name*any

    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.

  • ]
  • accountsinteger[]

    Account IDs to publish to.

    tagsinteger[]

    Tag IDs to attach.

    datestring<date>
    Example: 2025-06-01
    timestring
    Example: 10:00
    timezonestring

    Timezone date, time and accounts_schedule are read in. Defaults to the workspace timezone.

    Example: America/New_York
    accounts_schedule object[]

    Per-account departure times. When omitted on update, accounts keep their offsets from the post time.

  • Array [
  • account_idintegerrequired

    ID of one of the post's accounts. Entries for accounts the post does not carry are ignored.

    datestring<date>required
    Example: 2026-11-01
    timestringrequired

    H:i, read in the request timezone. Must not be in the past.

    Example: 14:30
  • ]
  • scheduleboolean

    Schedule the post for the given date/time.

    schedule_nowboolean

    Publish immediately.

    queueboolean

    Add to the smart publishing queue.

    ai_generatedboolean

    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.

    allow_duplicateboolean

    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.

    Default value: false
    PostInput
    {
    "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
    }