Platforms
Post TikTok videos, photos and photo carousels with privacy, duet and stitch options; limits, options and credit cost.
Sandbox
In the sandbox these options are validated exactly as in production, but nothing is posted: each target gets a simulated result and a preview page. The outcomes described here (for example privacy levels, drafts and auto-added music) are production behaviour and apply once live platform access opens.
Use "platform": "tiktok".
content is the caption (2,200 characters). For photo posts content is the title (90
characters); put longer text in description.platformSpecificData| Field | Type | Description |
|---|---|---|
privacyLevel | string | PUBLIC_TO_EVERYONE (default), MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR or SELF_ONLY. |
disableComment | boolean | Turn comments off. |
disableDuet | boolean | Turn duets off (videos only). |
disableStitch | boolean | Turn stitches off (videos only). |
brandContentToggle | boolean | Mark as branded content (paid partnership). |
brandOrganicToggle | boolean | Mark as organic brand promotion. |
isAigc | boolean | AI-generated content disclosure. |
videoCoverTimestampMs | integer | Frame to use as the video cover, in milliseconds. |
autoAddMusic | boolean | Add background music to photo posts. Defaults to true. |
photoCoverIndex | integer | 0-based index of the carousel cover image. |
description | string | Description for photo posts, up to 4,000 characters. |
draft | boolean | Send to the creator's TikTok inbox as a draft instead of publishing. |
{
"content": "Three tips for faster builds #devtips",
"platforms": [{
"platform": "tiktok",
"accountId": "acc_3t6k9m2n5b8v1c4x7z0l3j6h",
"platformSpecificData": { "privacyLevel": "PUBLIC_TO_EVERYONE", "disableDuet": true }
}],
"mediaItems": [{ "type": "video", "url": "https://cdn.example.com/tips.mp4" }],
"publishNow": true
}1 credit per TikTok target.