Publishing

Publish a Post

Publish a draft post directly to TikTok:

POST /api/v1/posts/:id/publish

Request body

{
  "tiktok_account_id": "uuid-of-connected-account"
}

Response

{
  "data": {
    "publish_id": "tiktok_publish_id"
  }
}

The post status will be updated to posted and posted_at will be set.

Scheduling

Schedule a post for automatic publishing:

PATCH /api/v1/posts/:id

Request body

{
  "status": "scheduled",
  "scheduled_at": "2026-03-15T14:00:00Z",
  "tiktok_account_id": "uuid-of-connected-account"
}

Scheduled posts are published automatically by a background job that runs every 5 minutes. The scheduled time must be at least 5 minutes in the future.

Privacy Levels

When publishing to TikTok, the default privacy level is PUBLIC_TO_EVERYONE. TikTok supports:

• PUBLIC_TO_EVERYONE — visible to all users
• MUTUAL_FOLLOW_FRIENDS — visible to mutual followers
• SELF_ONLY — only visible to the poster

Dispatch Logs

Every publish attempt is logged. View dispatch history in the Analytics page or query the database directly.