TikTok: posztolási szabályok és beállítások
Mit fogad el a TikTok csatorna a Postyban: média, korlátok, kötelező mezők, és a settings objektum mezői az API-hoz.
Basics
tiktokPost types
The same channel accepts more than one kind of post, and each kind has different requirements. The table shows what you need for each.
| Type | Media | Notes |
|---|---|---|
| Video, publish | 1 video | content_posting_method: DIRECT_POST. This is the one that actually publishes. |
| Photo post | 1 or more images | Duet, stitch, and the AI label do not apply to photos. |
| Send to inbox | 1 video | content_posting_method: UPLOAD. The user has to finish it manually within 24 hours. |
Rules
- The posting method decides what happens. DIRECT_POST actually publishes the post. UPLOAD only puts it in the user's TikTok app inbox, where they have 24 hours to finish it by hand, or it is lost.
- In UPLOAD mode, TikTok discards every setting except the title.
- Visibility has no default on purpose: TikTok's policy requires the publisher to choose.
- Duet, stitch, and the AI label only apply to video. TikTok does not handle them on photo posts.
Settings fields
These fields go into the post's settings object, alongside the __type field. In the UI, you fill in the same ones in the channel's settings section.
| Field | Type | Required | What it does |
|---|---|---|---|
| content_posting_method | "DIRECT_POST" | "UPLOAD" | yes | Publish, or only send to the user's inbox. |
| privacy_level | "PUBLIC_TO_EVERYONE" | "MUTUAL_FOLLOW_FRIENDS" | "FOLLOWER_OF_CREATOR" | "SELF_ONLY" | yes | The post's visibility. Required for DIRECT_POST, with no default. |
| title | string, up to 90 characters | no | The post title. In UPLOAD mode, this is the only setting TikTok keeps. |
| duet | boolean | yes | Allows duets. Video only. |
| stitch | boolean | yes | Allows stitching. Video only. |
| comment | boolean | yes | Allows comments. |
| autoAddMusic | "yes" | "no" | yes | Automatically add music. Photo posts only. |
| brand_content_toggle | boolean | yes | Marks it as branded content. |
| brand_organic_toggle | boolean | yes | Marks it as your own brand content. |
| video_made_with_ai | boolean | no | Marks it as a video made with AI. Video only. |
Allowed values
The fields below only accept these values. Any other value returns a 400, and the response names the field.
content_posting_method
| Value | Meaning |
|---|---|
| DIRECT_POST | TikTok publishes the post. |
| UPLOAD | It only goes to the inbox. TikTok discards every setting except the title. |
privacy_level
| Value | Meaning |
|---|---|
| PUBLIC_TO_EVERYONE | Public. |
| MUTUAL_FOLLOW_FRIENDS | Only mutual followers. |
| FOLLOWER_OF_CREATOR | Only followers. |
| SELF_ONLY | Only you. |
autoAddMusic
| Value | Meaning |
|---|---|
| yes | TikTok adds music under the photo post. |
| no | No music. |
Examples
Each example is one item in the POST /public/v1/posts request's posts array. The envelope around it is always this:
{
"type": "schedule",
"date": "2026-09-15T09:00:00.000Z",
"shortLink": false,
"posts": [ /* az alábbi elem */ ]
}Video, public
Visibility has no default. TikTok's policy requires you to choose one.
{
"integration": { "id": "<tiktok-csatorna>" },
"value": [{
"content": "<p>A videó leírása.</p>",
"image": [{ "id": "<media>", "path": "https://uploads.posty.hu/video.mp4" }]
}],
"settings": {
"__type": "tiktok",
"content_posting_method": "DIRECT_POST",
"privacy_level": "PUBLIC_TO_EVERYONE",
"title": "A videó címe",
"duet": true,
"stitch": true,
"comment": true,
"autoAddMusic": "no",
"brand_content_toggle": false,
"brand_organic_toggle": false
}
}Photo post
duet, stitch, and video_made_with_ai are ignored for photos.
{
"integration": { "id": "<tiktok-csatorna>" },
"value": [{
"content": "<p>Három kép a hétvégéről.</p>",
"image": [
{ "id": "<media-1>", "path": "https://uploads.posty.hu/1.jpg" },
{ "id": "<media-2>", "path": "https://uploads.posty.hu/2.jpg" }
]
}],
"settings": {
"__type": "tiktok",
"content_posting_method": "DIRECT_POST",
"privacy_level": "PUBLIC_TO_EVERYONE",
"title": "Hétvége",
"duet": false,
"stitch": false,
"comment": true,
"autoAddMusic": "yes",
"brand_content_toggle": false,
"brand_organic_toggle": false
}
}The channel ID comes from the channel list, and the path values for images and videos from media upload. The exact schema for the connected account comes from the settings schema endpoint. From the command line, the same thing is the --settings flag. See the CLI examples.