Home / Docs / TikTok

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.

Last updated: 2026-08-11 · Technical source: live Postifys API behavior and API reference

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 TikTok FILE_UPLOAD.
  • caption - Optional.
  • postMode - direct (default with approved scopes) or inbox.
  • privacy - Required for Direct Post and must be allowed for the creator.
  • consent and musicUsageConfirmed - Must be true for 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.

Continue learning