Sign in
Creator Messages

Send a staged draft to the creator

Deliver a previously staged draft to the creator and remove it. This is the confirm step of a draft-then-confirm flow: the message body comes from the draft row, never from this request, so what the operator reviewed is what is sent. The draft is claimed (removed) before the send so the same id cannot go out twice, even from two concurrent requests; a draft TikTok refuses (including the daily / weekly messaging caps, returned as 429) is put back for the inbox. Idempotency-Key required. X-Dry-Run: true resolves the draft and checks ownership without contacting TikTok.

post/creator-messages/drafts/{draft_id}/send

Path parameters

draft_idinteger required

Headers

Idempotency-Keystring nullable
X-Dry-Runstring nullable

Response

Dry-run — draft resolved and echoed, nothing sent.

dry_runboolean
would_send_draft_idinteger required
conversation_idinteger required
content_typestring required
textstring nullable
image_urlstring nullable
product_idstring nullable

Changes

Changed in 1 of the 26 revisions of this API.1

Of the 26 revisions, 1 has no diff computed.