Sign in
Creator Messages

Stage a draft reply on a creator conversation

Persist a reply on the conversation WITHOUT delivering it to the creator. The draft surfaces in the Reacher inbox for a human to review and either send via the existing /reply* endpoints or discard via DELETE /drafts/{id}. Idempotency-Key required. X-Dry-Run: true validates and echoes without persisting.

post/creator-messages/draft

Headers

Idempotency-Keystring nullable
X-Dry-Runstring nullable

Request body

creator_handlestring required

The creator's TikTok handle (with or without leading @). Must already have an open conversation with this shop — drafts can only be staged on existing conversations, the same prerequisite TikTok enforces on the live-send path.

textstring nullable

Plain-text reply body. Set this OR image_url OR product_id (exactly one). message is accepted as an alias: it is what an assistant reaches for, and with extra=forbid the mismatch was a schema rejection before the clearer route-level validation below could run (CORE-6957).

image_urlstring nullable

HTTPS URL of an image to send. Same SSRF + size + type constraints as the live /reply/image endpoint will apply when the human ships the draft — we do NOT fetch the URL at draft time (no outbound network call from this endpoint). Set this OR text OR product_id (exactly one).

product_idstring nullable

A TikTok product_id from THIS shop's catalog. Ownership is verified ONLY when the human clicks Send in the inbox — the draft endpoint does not pre-check the catalog (the catalog can change between draft and send anyway). Set this OR text OR image_url (exactly one).

Response

Dry-run — validated and echoed, nothing persisted.

dry_runboolean
would_create_for_handlestring required
content_typestring required
textstring nullable
image_urlstring nullable
product_idstring nullable

Changes

No recorded changes to this endpoint across all 1 revision of this API.