Settings Schema
When uploading a video to TikTok, use the following settings schema:
Fields
| Field | Type | Required | Description |
|---|
__type | string | Yes | Must be tiktok |
title | string | No | Video title (max 90 characters) |
privacy_level | string | Yes | Who can view the video |
duet | boolean | Yes | Allow duets |
stitch | boolean | Yes | Allow stitches |
comment | boolean | Yes | Allow comments |
autoAddMusic | string | Yes | Auto-add music to video |
brand_content_toggle | boolean | Yes | Branded content disclosure |
brand_organic_toggle | boolean | Yes | Organic branded content |
video_made_with_ai | boolean | No | AI-generated content disclosure |
content_posting_method | string | Yes | How to post the content |
privacy_level
| Value | Description |
|---|
PUBLIC_TO_EVERYONE | Anyone can view |
MUTUAL_FOLLOW_FRIENDS | Only mutual followers can view |
FOLLOWER_OF_CREATOR | Only your followers can view |
SELF_ONLY | Only you can view |
autoAddMusic
| Value | Description |
|---|
yes | TikTok will auto-add music |
no | No automatic music |
content_posting_method
| Value | Description |
|---|
DIRECT_POST | Post directly to TikTok |
UPLOAD | Upload for manual posting |
Complete Example
Public Video with Interactions Enabled
Branded Content Video
AI-Generated Content
Private Video (Draft)
Important: TikTok requires media files to be publicly accessible via HTTPS. Private URLs will fail. Media you upload to Groniz is served over public HTTPS and works out of the box; if you pass your own URL, make sure it is publicly reachable.