TikTok
TikTok supports video posts and Photo Mode slideshows. It is the most configurable platform with required privacy settings and optional content disclosure toggles.
Media Constraints
| Constraint | Videos | Images (Photo Mode) |
|---|---|---|
| Formats | MP4 (H.264) | JPEG, PNG |
| Max file size | 500 MB | 5 MB per image |
| Count per post | Exactly 1 | 1 to 10 images |
| Max duration | 10 minutes | n/a |
| Text-only | Not supported | Not supported |
| Mix images + video | Not allowed | Not allowed |
Photo Mode takes 1 to 10 images, the most a Quegly post carries on any platform. Quegly sends them to TikTok as one photo post, in the order of media_ids, with the first as its cover. Whether TikTok accepts a post with a single photo is up to TikTok.
Platform Settings
TikTok requires a platform_settings.tiktok object with at minimum a privacy_level or draft_mode.
Required Settings
| Parameter | Type | Description |
|---|---|---|
privacy_level | string | Who can see the post. One of: "PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "FOLLOWER_OF_CREATOR", "SELF_ONLY". Not required when draft_mode is true (defaults to SELF_ONLY). |
Draft Mode
| Parameter | Type | Description |
|---|---|---|
draft_mode | boolean | Send to TikTok drafts inbox instead of posting directly. Allows adding trending sounds in the TikTok app before publishing. When true, privacy_level defaults to SELF_ONLY if not set. |
Interaction Settings
| Parameter | Type | Description |
|---|---|---|
allow_comment | boolean | Allow comments on the post. Defaults to true. |
allow_duet | boolean | Allow duets (video posts only). Defaults to true. |
allow_stitch | boolean | Allow stitches (video posts only). Defaults to true. |
Content Disclosure
| Parameter | Type | Description |
|---|---|---|
commercial_content | boolean | Enable commercial content disclosure. Defaults to false. |
brand_organic | boolean | Self-promotion flag ("Your Brand"). Cannot be combined with brand_content. |
brand_content | boolean | Paid partnership flag ("Branded Content"). Cannot be combined with brand_organic or privacy_level SELF_ONLY. |
Music (Photo Mode only)
| Parameter | Type | Description |
|---|---|---|
auto_add_music | boolean | Tells TikTok to auto-add a recommended track to the slideshow. Photo Mode posts only. Ignored on videos. Cannot be used with draft_mode (the drafts inbox doesn't accept this flag; it's a DIRECT_POST-only field per TikTok's Content Posting API spec). Defaults to false. |
When to enable auto_add_music
TikTok's algorithm rewards Photo Mode slideshows with audio tracks over silent ones. Setting auto_add_music: true lets TikTok pick a fitting track at publish time and is the no-friction option for automated workflows. If you want manual control over the track instead, use draft_mode: true and pick one in the TikTok app before publishing.
Business Rules
Privacy level is required (unless draft mode)
Every TikTok post must specify a privacy_level, unless draft_mode is true. When draft_mode is enabled, privacy_level defaults to SELF_ONLY.
draft_mode sends to TikTok inbox
When draft_mode is true (or privacy_level is "SELF_ONLY"), the post is uploaded to your TikTok drafts inbox. This is useful for adding trending sounds and making final edits in the TikTok app before publishing.
Content disclosure constraints
If commercial_content is true, at least one of brand_organic or brand_content must be true. brand_organic and brand_content cannot both be true. brand_content cannot be combined with privacy_level: SELF_ONLY.
Duet and Stitch are video-only
The allow_duet and allow_stitch settings only apply to video posts. They are ignored for Photo Mode slideshows.
Examples
{
"type": "schedule",
"scheduled_at": "2026-06-01T14:00:00.000Z",
"caption": "My landlord said I can't change anything so I showed her this #fyp #roomtransformation",
"media_ids": ["video-id"],
"account_ids": ["tiktok-account-id"],
"platform_settings": {
"tiktok": {
"privacy_level": "PUBLIC_TO_EVERYONE",
"allow_comment": true,
"allow_duet": true,
"allow_stitch": true
}
}
}{
"type": "now",
"caption": "6 ways to redesign your kitchen without renovation #interiordesign #beforeandafter",
"media_ids": [
"slide-1-id", "slide-2-id", "slide-3-id",
"slide-4-id", "slide-5-id", "slide-6-id"
],
"account_ids": ["tiktok-account-id"],
"platform_settings": {
"tiktok": {
"draft_mode": true,
"allow_comment": true
}
}
}Tip for AI agents
TikTok's algorithm heavily favors posts with trending sounds. For slideshows: either set auto_add_music: true (TikTok picks the track), or use draft_mode: true and pick a track manually in the TikTok app before publishing.
Caption Rules
| Max length | 2,200 characters. Longer captions are rejected before the post is saved. |
| Hashtags | Include in caption text. TikTok currently limits to 5 hashtags. |