Posts a ready video to your connected accounts now, at a time (mode schedule), or in the profile queue. Only after preview_post passed and the user agreed: confirm must be true. For TikTok, pass the tiktok.privacy_level the user chose. idempotency_key: a new unique string per intended post. Repeat the same call with the same key only when it did not answer (timeout, network): you get the same post back, never a second one. A post that came back failed needs a new key; the same key with different arguments is refused (idempotency_mismatch). Counts one post per account against your plan.
View input schema
{
"type": "object",
"properties": {
"video_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$",
"description": "A ready video (list_videos / get_video status \"ready\")"
},
"profile_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$",
"description": "The profile to post from (list_profiles)"
},
"account_ids": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$"
},
"description": "Accounts of that profile to post to (list_profiles, postable: true)"
},
"caption": {
"type": "string",
"maxLength": 10000,
"description": "Post text on every network (on YouTube: the description)"
},
"title": {
"description": "Title for titled networks (YouTube); required when one is targeted",
"type": "string",
"maxLength": 500
},
"overrides": {
"type": "object",
"propertyNames": {
"type": "string",
"maxLength": 32
},
"additionalProperties": {
"type": "object",
"properties": {
"caption": {
"type": "string",
"maxLength": 10000
},
"title": {
"type": "string",
"maxLength": 500
}
}
},
"description": "Per network (tiktok, instagram, youtube, facebook, linkedin, threads, reddit, bluesky): a different caption and, on titled networks (YouTube), a different title. Networks left out use caption / title."
},
"mode": {
"type": "string",
"enum": [
"now",
"schedule",
"queue"
],
"description": "'now', 'schedule' (needs scheduled_at) or 'queue' (the profile's next free slot)"
},
"scheduled_at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
"description": "Local time YYYY-MM-DDTHH:mm in `timezone`"
},
"timezone": {
"description": "IANA zone, e.g. Europe/Madrid (default: the server default)",
"type": "string",
"maxLength": 64
},
"first_comment": {
"description": "Posted as the first comment where the network supports it",
"type": "string",
"maxLength": 10000
},
"ai_generated": {
"description": "Label the post as AI-generated where the network supports it (default: true for AI swaps, false for your own videos)",
"type": "boolean"
},
"youtube_privacy": {
"description": "YouTube visibility (default public)",
"type": "string",
"enum": [
"public",
"unlisted",
"private"
]
},
"tiktok": {
"type": "object",
"properties": {
"privacy_level": {
"description": "Who can view the TikTok post: PUBLIC_TO_EVERYONE (everyone), MUTUAL_FOLLOW_FRIENDS (friends (mutual followers)), FOLLOWER_OF_CREATOR (followers), SELF_ONLY (only me). Required to post directly to TikTok, and only the values list_profiles shows in the account's tiktok.privacy_level_options are allowed (preview_post lists them when one is missing or not allowed). There is no default: ask the user who can view it, never choose for them.",
"type": "string",
"enum": [
"PUBLIC_TO_EVERYONE",
"MUTUAL_FOLLOW_FRIENDS",
"FOLLOWER_OF_CREATOR",
"SELF_ONLY"
]
},
"post_mode": {
"description": "DIRECT_POST (default): published to the TikTok profile, needs privacy_level. MEDIA_UPLOAD: sent to the user's TikTok inbox as a draft they finish in the TikTok app (no privacy_level).",
"type": "string",
"enum": [
"DIRECT_POST",
"MEDIA_UPLOAD"
]
},
"disable_comment": {
"description": "Turn comments off on the TikTok post (default: on, unless the account turned them off)",
"type": "boolean"
},
"disable_duet": {
"description": "Turn Duet off (default: on, unless the account turned it off)",
"type": "boolean"
},
"disable_stitch": {
"description": "Turn Stitch off (default: on, unless the account turned it off)",
"type": "boolean"
},
"comment_in_caption": {
"description": "TikTok has no first comments: add first_comment to the end of the TikTok caption instead (default false)",
"type": "boolean"
}
},
"additionalProperties": false,
"description": "TikTok settings, used when a TikTok account is targeted. Ask the user who can view it (privacy_level) before preview_post."
},
"reddit": {
"description": "Required when a Reddit account is targeted",
"type": "object",
"properties": {
"subreddit": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "One subreddit, e.g. r/videos"
},
"flair_text": {
"type": "string",
"maxLength": 64
}
},
"required": [
"subreddit"
]
},
"confirm": {
"type": "boolean",
"const": true,
"description": "Must be true: the user agreed to publish"
},
"idempotency_key": {
"type": "string",
"minLength": 8,
"maxLength": 200,
"description": "A new unique string per intended post"
}
},
"required": [
"video_id",
"profile_id",
"account_ids",
"caption",
"mode",
"confirm",
"idempotency_key"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}