TikTok
Video and photo posts via the TikTok Content Posting API. Privacy controls, caption rules, and the quirks of TikTok's review queue.
TikTok integrates through the official Content Posting API. Posts go through TikTok's normal review pipeline — same as if you'd uploaded in-app — and appear in your followers' feeds when TikTok finishes scanning the video.
What you can post
| Type | Supported | Notes |
|---|---|---|
| Video | ✓ | MP4, 5 min max, up to 287 MB |
| Photo carousel | ✓ | 2-35 photos, JPG / PNG / WebP |
| Story / Now | — | Not in the API |
Caption rules
- Max length: 2,200 characters (TikTok officially says 4,000 but the API caps lower)
- Hashtags counted toward the character limit
- @-mentions work for any public TikTok handle
Video specs
- Format: MP4
- Codec: H.264; H.265 mostly works but inconsistent
- Resolution: Up to 1080×1920 (vertical) recommended
- Frame rate: 23-60 FPS
- Bit rate: Up to 12 Mbps; higher gets re-encoded harder
- Length: 3 sec minimum, 600 sec maximum (the "5 min" in TikTok's marketing means 5 minutes for in-app uploads; the API allows 10)
- File size: 287 MB max
If your video is bigger than ~150 MB we recommend re-exporting at a lower bitrate. The bigger the file, the longer TikTok's review queue takes — sometimes the difference between "live in 30 seconds" and "live in 20 minutes."
Per-post settings we expose
- Privacy — Public, Friends, Private. Defaults to Public.
- Allow comments — toggle.
- Allow Duet — toggle. Note: TikTok forces this off for accounts under 1,000 followers regardless of API setting.
- Allow Stitch — toggle. Same follower-count rule.
- Disclose content — required when the video promotes a brand or contains AI-generated content. We surface this as a toggle in the editor; not setting it correctly can get the video shadow-banned.
Photo carousel mode
TikTok's photo carousel (sometimes called "slideshow") takes 2-35 images and turns them into a swipeable post with TikTok's default sound or your selected music. The API caveats:
- You can't set a custom audio track per slide. TikTok adds the default photo-slideshow track. To override, post the video natively first then convert in-app (rare workflow).
- Aspect ratio: TikTok will display whatever you upload at the aspect of the first photo, letterboxing the rest. Match aspect ratios for clean output — our Carousel Splitter tool helps if you want square slides.
TikTok's review queue
Every post — through the API or the app — sits in a review queue that scans for ad content, copyrighted music, and rule violations. Most posts clear in under a minute. Some take 10-15 minutes. We poll the API every 30 seconds and update the post status when it's live.
If a post is "Under review" for more than an hour, that usually means TikTok flagged it for human review. The post stays in your account but isn't distributed until they finish; sometimes they never finish and the video just doesn't get reach. This is on TikTok's side; we can't do anything other than show you the status.
Common rejection reasons
video_pull_failed— TikTok couldn't download the video from our staging URL. Usually transient; we auto-retry.spam_risk_user_banned_from_posting— your TikTok account is rate-limited or shadow-banned. Wait 24 hours and try again.unaudited_client_can_only_post_to_private_accounts— you've authenticated with a TikTok account that hasn't completed TikTok's "Posting" verification. Open the TikTok app, complete the "Add a date of birth" / phone-number flow, reconnect.