TikTok integration uses the TikTok Business API. Connect a TikTok Business account — personal creator accounts without Business access are not supported.
Connect
curl -X POST "https://backend.postsiva.com/unified/oauth/url" \
-H "Content-Type: application/json" \
-H "X-API-Key: psk_live_YOUR_KEY" \
-d '{"platform": ["tiktok"]}'
/tiktok-business/oauth/callback. One TikTok Business account per workspace.
Post types
| Type | Endpoint | Primary use |
|---|
| Video | POST /unified/post/video | Short-form video (main workflow) |
| Image | POST /unified/post/image | Photo posts |
| Carousel | POST /unified/post/carousel | Multi-image photo posts |
Video post (recommended)
curl -X POST "https://backend.postsiva.com/unified/post/video" \
-H "Content-Type: application/json" \
-H "X-API-Key: psk_live_YOUR_KEY" \
-d '{
"platforms": ["tiktok"],
"default_text": "Behind the scenes at our studio.",
"video_id": "your-video-media-uuid",
"tiktok": {
"privacy_level": "PUBLIC_TO_EVERYONE",
"disable_comment": false
}
}'
privacy_level options
| Value | Who can view |
|---|
PUBLIC_TO_EVERYONE | Default — public on TikTok |
MUTUAL_FOLLOW_FRIENDS | Mutual followers only |
FOLLOWER_OF_CREATOR | Followers only |
SELF_ONLY | Private — only you |
tiktok.privacy_level in the post body.
Caption and title limits
| Field | Limit | Applies to |
|---|
Caption (default_text / tiktok_text) | 2,200 characters | Video and photo posts |
Photo title (tiktok_title) | 90 UTF-16 code units | Image and carousel posts only |
{
"platforms": ["tiktok"],
"default_text": "Photo carousel caption.",
"image_ids": ["id1", "id2"],
"tiktok": {
"tiktok_title": "Summer lookbook",
"privacy_level": "PUBLIC_TO_EVERYONE",
"auto_add_music": true
}
}
Additional TikTok options
| Field | Type | Description |
|---|
disable_comment | boolean | Disable comments |
auto_add_music | boolean | Let TikTok add music to photo posts |
brand_content_toggle | boolean | Mark as branded content |
brand_organic_toggle | boolean | Brand organic disclosure |
cover_index | integer | Cover image index for multi-image (0-based) |
video_cover_timestamp_ms | integer | Frame timestamp for video cover |
Video focus
TikTok is video-first. Recommended workflow:
- Upload video via
POST /media/upload (or chunked upload for files ≥ 10 MB)
- Copy returned
media_id
- Post with
video_id and caption
- Optionally schedule with
scheduled_time
Postsiva normalizes images to 1080×1920 (9:16) for TikTok when auto-fix is applied.
{
"platforms": ["tiktok", "instagram", "youtube"],
"default_text": "Product demo.",
"video_id": "shared-video-uuid",
"youtube": {
"youtube_title": "Product Demo — Full Walkthrough",
"youtube_description": "See our new feature in action."
}
}
Common errors
| Error | Cause | Fix |
|---|
NOT_CONNECTED | TikTok Business not linked | Reconnect via OAuth |
422 caption | Over 2,200 characters | Shorten caption |
422 photo title | Over 90 UTF-16 units | Shorten tiktok_title |
| Invalid privacy | Unknown privacy_level value | Use enum values above |