Publish to TikTok

Publish videos directly to a TikTok account.

POST/api/v1/publish/tiktok

Request Body

Parameter	Type	Required	Description
mediaId	string	Yes	Media ID to publish (video only)
tiktokAccountId	string (UUID)	Yes	The connected TikTok account ID
caption	string	No	Post caption (max 2200 characters)
privacyLevel	string	No	Privacy level (default SELF_ONLY)
isAigc	boolean	No	Flag content as AI-generated (default true)
postMode	string	No	`"direct"` \| `"inbox"` (default direct)

Response

The operation is asynchronous. The initial response returns an outputJobId and a status of queued. Poll GET /jobs/publish/{outputJobId} until the status reaches a terminal value (succeeded or failed).

{
  "outputJobId": "oj_...",
  "status": "queued"
}

Example

POST/api/v1/publish/tiktok

{
  "mediaId": "media_abc",
  "tiktokAccountId": "550e8400-e29b-41d4-a716-446655440000",
  "caption": "Made with AI #wonda",
  "privacyLevel": "SELF_ONLY",
  "isAigc": true,
  "postMode": "direct"
}