TikTok Settings
OpenQuok public API provider settings for TikTok — direct post vs inbox upload, privacy, photo title, and brand disclosure toggles.
3 min read
Connect your agent today
Draft from chat, review in your calendar, and publish only what you approve.
Quick reference
| Property | Value |
|---|---|
| Identifier | tiktok |
| Connect | GET /api/v1/public/social/tiktok |
| Setup guide | TikTok |
| Character cap | 2,000 (caption) |
| Main-post media | ≥1 attachment; one MP4 or 1–35 JPEG/PNG/WEBP photos (never mixed) |
| Photo title | ≤90 characters when posting a photo carousel |
Warning
content_posting_method: UPLOAD (creator inbox) and privacy_level: SELF_ONLY on direct post are different workflows. Inbox upload does not send privacy_level.
Settings on create post
Flat keys and the tiktok nested bucket are both accepted.
| Flat CLI / API key | Nested composer bucket | Purpose |
|---|---|---|
| content_posting_method | tiktok.content_posting_method | DIRECT_POST or UPLOAD (inbox) |
| privacy_level | tiktok.privacy_level | Direct post only — who can view |
| title | tiktok.title | Photo carousel title (≤90 chars) |
| comment | tiktok.comment | Allow comments |
| duet | tiktok.duet | Allow duets |
| stitch | tiktok.stitch | Allow stitches |
| brand_content_toggle | — | Branded content disclosure |
| brand_organic_toggle | — | Brand organic disclosure |
| video_made_with_ai | — | AI-generated or AI-edited disclosure |
Privacy levels (direct post)
| Value | Meaning |
|---|---|
| PUBLIC_TO_EVERYONE | Public |
| MUTUAL_FOLLOW_FRIENDS | Friends |
| FOLLOWER_OF_CREATOR | Followers |
| SELF_ONLY | Private on profile (finish in app, then switch to public) |
{
"providerSettingsByIntegrationId": {
"<tiktok-integration-id>": {
"content_posting_method": "DIRECT_POST",
"privacy_level": "PUBLIC_TO_EVERYONE",
"comment": true,
"duet": false,
"stitch": false,
"video_made_with_ai": false
}
}
}Field reference
| Field | Type | Required | Notes |
|---|---|---|---|
| content_posting_method | string | No | DIRECT_POST (default) publishes to profile; UPLOAD sends to creator inbox |
| privacy_level | string | No | Direct post only — omitted when method is UPLOAD |
| title | string | For photo posts | Carousel title, max 90 characters |
| comment | boolean | No | Interaction toggle |
| duet | boolean | No | Interaction toggle |
| stitch | boolean | No | Interaction toggle |
| brand_content_toggle | boolean | No | Branded content |
| brand_organic_toggle | boolean | No | Brand organic |
| video_made_with_ai | boolean | No | AI disclosure |
TikTok does not support follow-up comments via providerSettingsByIntegrationId.
Complete example
Direct-post video:
curl -X POST https://api.openquok.com/api/v1/public/posts
-H "Authorization: Bearer opo_your_programmatic_token"
-H "Content-Type: application/json"
-d '{
"body": "Behind the scenes of our launch day.",
"scheduledAt": "2026-05-15T20:00:00.000Z",
"status": "scheduled",
"integrationIds": ["<tiktok-integration-id>"],
"isGlobal": true,
"media": [{ "id": "video-1", "path": "FILE_PATH_FROM_UPLOAD" }],
"providerSettingsByIntegrationId": {
"<tiktok-integration-id>": {
"content_posting_method": "DIRECT_POST",
"privacy_level": "PUBLIC_TO_EVERYONE",
"comment": true
}
}
}'Send to creator inbox (finish trending audio in the TikTok app):
{
"body": "Draft for inbox — add sound in app.",
"scheduledAt": "2026-05-15T20:00:00.000Z",
"status": "scheduled",
"integrationIds": ["<tiktok-integration-id>"],
"isGlobal": true,
"media": [{ "id": "video-1", "path": "FILE_PATH_FROM_UPLOAD" }],
"providerSettingsByIntegrationId": {
"<tiktok-integration-id>": {
"content_posting_method": "UPLOAD"
}
}
}