Skip to main content

Settings Schema

When uploading a video to TikTok, use the following settings schema:

Fields

FieldTypeRequiredDescription
__typestringYesMust be tiktok
titlestringNoVideo title (max 90 characters)
privacy_levelstringYesWho can view the video
duetbooleanYesAllow duets
stitchbooleanYesAllow stitches
commentbooleanYesAllow comments
autoAddMusicstringYesAuto-add music to video
brand_content_togglebooleanYesBranded content disclosure
brand_organic_togglebooleanYesOrganic branded content
video_made_with_aibooleanNoAI-generated content disclosure
content_posting_methodstringYesHow to post the content

privacy_level

ValueDescription
PUBLIC_TO_EVERYONEAnyone can view
MUTUAL_FOLLOW_FRIENDSOnly mutual followers can view
FOLLOWER_OF_CREATOROnly your followers can view
SELF_ONLYOnly you can view

autoAddMusic

ValueDescription
yesTikTok will auto-add music
noNo automatic music

content_posting_method

ValueDescription
DIRECT_POSTPost directly to TikTok
UPLOADUpload 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. Local files or private URLs will fail. Use Cloudflare R2 or similar storage with public access.