TikTok settings
TikTok’s settings object is the strictest in Sharek, because TikTok enforces its own rules about visibility and commercial disclosure and rejects posts that break them.
Fields
Section titled “Fields”| Field | Required | Description |
|---|---|---|
content_posting_method |
Yes | DIRECT_POST or UPLOAD. See below, the difference is large. |
privacy_level |
Yes for DIRECT_POST |
PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR or SELF_ONLY. |
title |
No | Photo posts only: the post’s title, maximum 90 characters. Sharek ignores it on a video, where a direct post takes its title from the post’s content. |
duet |
Yes | Boolean. Allow duets. Video posts only. |
stitch |
Yes | Boolean. Allow stitches. Video posts only. |
comment |
Yes | Boolean. Allow comments. |
autoAddMusic |
Yes | yes or no. Photo posts only. |
disclose |
No | Boolean. Turns on commercial content disclosure. Defaults to false. |
brand_organic_toggle |
Yes | Boolean. “Your brand”: the post promotes your own brand. |
brand_content_toggle |
Yes | Boolean. “Branded content”: the post promotes a third party. |
video_made_with_ai |
No | Boolean. Labels the video as AI generated. Video posts only. |
The schema also lists music and location. This channel accepts both but ignores them,
so leave them out.
Direct post versus upload
Section titled “Direct post versus upload”This is the field to get right.
| Value | What happens |
|---|---|
DIRECT_POST |
Sharek publishes the post to TikTok. Every setting here applies. |
UPLOAD |
Sharek sends the media to the TikTok app’s inbox as a draft. Nothing is published. The person has to finish and publish it in the TikTok app within 24 hours or it is discarded. |
Visibility has no default
Section titled “Visibility has no default”TikTok forbids pre-selecting a visibility, so privacy_level must be chosen
deliberately for a direct post. TikTok also allows different subsets per account:
public and private accounts get different options, so a value valid for one account can
be refused for another. A value outside the four above, or none on a direct post, is
refused when you create the post with Choose who can see this post. A value TikTok
does not offer that account passes that check and fails when TikTok publishes it, with
Privacy level mismatch, please check privacy settings.
Commercial content disclosure
Section titled “Commercial content disclosure”Two cross-field rules are enforced when content_posting_method is DIRECT_POST:
- If
discloseis true, at least one ofbrand_organic_toggleorbrand_content_togglemust also be true. Otherwise the post is refused withYou need to indicate if your content promotes yourself, a third party, or both. - If
brand_content_toggleis true,privacy_levelcannot beSELF_ONLY. Branded content may not be private. The refusal readsBranded content visibility cannot be set to private.
With both toggles true, TikTok labels the post “Paid partnership” rather than “Promotional content”.
Neither rule is applied to an UPLOAD, since TikTok ignores the fields there anyway.
Video and photo posts differ
Section titled “Video and photo posts differ”duet,stitchandvideo_made_with_aiare video only. TikTok has no equivalent for photo posts.autoAddMusicis photo only.
The fields stay required in the request either way; TikTok simply ignores the ones that do not apply.
Duets, stitches and comments start off
Section titled “Duets, stitches and comments start off”Leave duet, stitch and comment at false unless the creator wants them: TikTok
requires these interactions to start unselected. If the creator has turned one off in
their own TikTok privacy settings, TikTok refuses a post that turns it on.
Sharek checks a TikTok post’s media when you create it:
- A post needs at least one picture or video. One without media is refused with
No video / images selected. - Several items must all be pictures, so a video is always the only item. A video
alongside other items is refused with
Only pictures are supported when selecting multiple items. - Each picture’s shorter side can be at most 1080px. A larger one is refused with a
message that names it, such as
Image 2 is 1440x1920, TikTok allows a maximum of 1080px on the shorter side.
The caption, the post’s content, can be up to 2000 characters.
Example
Section titled “Example”A public video post, no commercial disclosure:
"settings": { "content_posting_method": "DIRECT_POST", "privacy_level": "PUBLIC_TO_EVERYONE", "duet": false, "stitch": false, "comment": false, "autoAddMusic": "no", "disclose": false, "brand_organic_toggle": false, "brand_content_toggle": false}A branded-content post:
"settings": { "content_posting_method": "DIRECT_POST", "privacy_level": "PUBLIC_TO_EVERYONE", "title": "Our collaboration", "duet": false, "stitch": false, "comment": false, "autoAddMusic": "no", "disclose": true, "brand_organic_toggle": false, "brand_content_toggle": true}Send these under settings in create a post. Read a channel’s live
schema with channel settings. Connect the channel first:
connecting your channels.