Skip to content

TikTok

TikTok videos and photo posts through PostFlow, inbox drafts, privacy and Business music.

Id Format Media Kinds Aspect (w/h) Video length Max size (image / video) Caption max
tt_video Video 1 video – 3–600 s – / 4 GB 2,200
tt_photo Photo post 1–35 image – – 20 MB / – 4,000

PostFlow posts in one of two ways, depending on the account and PostFlow’s TikTok access:

Mode What happens Target status
Inbox draft The video lands in the creator’s TikTok inbox. They add a sound if they like and post it in the app. PostFlow then finds the published video (matching caption first, then time) and marks it published. handed_off → published
Direct post Published straight to the profile with the chosen privacy and settings. TikTok Business accounts always post directly. published

A post.handoff webhook tells you when a draft is waiting.

TikTok requires the creator to choose who can see each post, from the options their account allows, with no default. Read them with GET /accounts/{id}/tiktok-creator-info (MCP: get_tiktok_creator_info):

{ "nickname": "Kopi Senja", "privacyLevelOptions": ["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "SELF_ONLY"],
"commentDisabled": false, "duetDisabled": false, "stitchDisabled": false, "maxVideoPostDurationSec": 600 }
Option Notes
tiktok.privacyLevel One of privacyLevelOptions. Required for direct posts and photo posts.
tiktok.disableComment, disableDuet, disableStitch Only if the creator hasn’t already turned them off.
tiktok.brandOrganic, brandContent Commercial content disclosure: promoting your own brand, or paid partnership.
tiktok.autoAddMusic Photo posts: let TikTok add music.
tiktok.music Business accounts: a Commercial Music Library track from GET /accounts/{id}/tiktok-music, with volume and originalVolume (0–100).
cover.offsetMs Direct video posts: the cover frame.

No first comments: TikTok doesn’t let apps comment.

Views, likes, comments and shares; reach for Business accounts. Inbox drafts get metrics once PostFlow finds the published video.