TikTok draft ready

POST

A TikTok video is waiting in the account’s TikTok inbox for the creator to finish.

Headers: X-PostFlow-Event, X-PostFlow-Signature: t=<unix>,v1=<hex> (HMAC-SHA256 of "<t>.<body>" with the webhook’s secret). Answer 2xx within 10 seconds.

Authorizations

• apiKey
• oauth

Request Body^required

Media typeapplication/json

object

event

required

string

Allowed value: post.handoff

deliveredAt

required

string format: date-time

workspaceId

required

string

post

required

object

id

required

string

caption

required

string

scheduledAt

required

Any of:

string

string format: date-time

null

null

target

required

object

id

required

string

platform

required

string

Allowed values: facebook instagram tiktok threads bluesky youtube telegram

account

required

object

name

required

string

username

required

Any of:

string

string

null

null

contentType

required

string

Allowed values: fb_post fb_photo fb_video fb_reel ig_image ig_carousel ig_reel ig_story tt_video tt_photo th_text th_image th_video th_carousel tg_message tg_media bs_post bs_video yt_short yt_video

status

required

string

Allowed values: draft scheduled queued publishing published handed_off failed paused needs_reschedule

permalink

required

Any of:

string

string

null

null

externalPostId

required

Any of:

string

string

null

null

publishedAt

required

Any of:

string

string format: date-time

null

null

error

required

Any of:

object

object

code

required

Any of:

string

string

null

null

message

required

string

null

null

Responses

200

Received. Any 2xx works; anything else is retried.