TikTok Publishing Docs
Publish TikTok videos automatically with approved Direct Post, or choose optional Draft Upload when the creator wants to finish editing in TikTok.
Quick answer: Use
POST /api/tiktok/post with postMode: "direct" to publish automatically, or postMode: "inbox" for Draft Upload.Direct Post review: Select an allowed privacy level, respect creator interaction capabilities, obtain explicit consent, and confirm TikTok’s Music Usage Confirmation before submission.
What Postifys supports
Approved Direct Post for automatic video publishing and optional Draft Upload for completion in TikTok.
Product overview: TikTok integration. Full field reference also lives on API docs.
Endpoint
POST /api/tiktok/post · Auth: API key or session · Target field: tiktokAccountId when needed
Permissions / scopes: video.publish for Direct Post, video.upload for Draft Upload, and user.info.basic.
Common fields
tiktokAccountId- Optional when only one TikTok account is connected.videoUrl- Required; Postifys downloads and transfers the video with TikTokFILE_UPLOAD.caption- Optional.postMode-direct(default with approved scopes) orinbox.privacy- Required for Direct Post and must be allowed for the creator.consentandmusicUsageConfirmed- Must betruefor Direct Post.disableComment / disableDuet / disableStitch- Must respect the creator’s capabilities.
cURL example
curl -X POST https://postifys.com/api/tiktok/post \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"tiktokAccountId": "OPEN_ID_FROM_CONNECTIONS",
"videoUrl": "https://example.com/video.mp4",
"caption": "Published automatically with Postifys",
"postMode": "direct",
"privacy": "PUBLIC_TO_EVERYONE",
"disableComment": false,
"disableDuet": false,
"disableStitch": false,
"consent": true,
"musicUsageConfirmed": true
}'Limitations
- Privacy and interaction choices must come from the connected creator’s current capabilities.
- Direct Post is asynchronous; poll the returned publish status until complete or failed.
- Draft Upload still requires the creator to finish publishing inside TikTok.
- Video eligibility follows TikTok media and policy rules.
See also Media requirements, Errors, and Rate limits.