Skip to main content

​
Settings Schema

When uploading a video to TikTok, use the following settings schema: 
{
  "settings": {
    "__type": "tiktok",
    "title": "",
    "privacy_level": "PUBLIC_TO_EVERYONE",
    "duet": false,
    "stitch": false,
    "comment": true,
    "autoAddMusic": "no",
    "brand_content_toggle": false,
    "brand_organic_toggle": false,
    "video_made_with_ai": false,
    "content_posting_method": "DIRECT_POST"
  }
}

​
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

{
  "type": "schedule",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-tiktok-integration-id"
      },
      "value": [
        {
          "content": "Check out this awesome tip! 🔥 #tips #viral #fyp",
          "image": [
            {
              "id": "video-id",
              "path": "https://uploads.postiz.com/tiktok-video.mp4"
            }
          ]
        }
      ],
      "settings": {
        "__type": "tiktok",
        "title": "Quick Productivity Tip",
        "privacy_level": "PUBLIC_TO_EVERYONE",
        "duet": true,
        "stitch": true,
        "comment": true,
        "autoAddMusic": "no",
        "brand_content_toggle": false,
        "brand_organic_toggle": false,
        "video_made_with_ai": false,
        "content_posting_method": "DIRECT_POST"
      }
    }
  ]
}

​
Branded Content Video

{
  "settings": {
    "__type": "tiktok",
    "title": "Partnership with Brand",
    "privacy_level": "PUBLIC_TO_EVERYONE",
    "duet": false,
    "stitch": false,
    "comment": true,
    "autoAddMusic": "no",
    "brand_content_toggle": true,
    "brand_organic_toggle": true,
    "video_made_with_ai": false,
    "content_posting_method": "DIRECT_POST"
  }
}

​
AI-Generated Content

{
  "settings": {
    "__type": "tiktok",
    "title": "AI Generated Art",
    "privacy_level": "PUBLIC_TO_EVERYONE",
    "duet": true,
    "stitch": true,
    "comment": true,
    "autoAddMusic": "yes",
    "brand_content_toggle": false,
    "brand_organic_toggle": false,
    "video_made_with_ai": true,
    "content_posting_method": "DIRECT_POST"
  }
}

​
Private Video (Draft)

{
  "settings": {
    "__type": "tiktok",
    "title": "",
    "privacy_level": "SELF_ONLY",
    "duet": false,
    "stitch": false,
    "comment": false,
    "autoAddMusic": "no",
    "brand_content_toggle": false,
    "brand_organic_toggle": false,
    "content_posting_method": "UPLOAD"
  }
}
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.