Account & Billing6

Affiliate Orders1

AI Search8

Analytics8

Automations26

Briefs15

Campaign Content & Challenges11

Campaigns25

Cohort Analysis5

Contracts8

Creator Messages12

Creators9

CRM Groups3

CRM Roster4

CRM Tags2

Discord6

Discovery Agent7

Email Accounts1

Finance5

GMV Max59

Halo Effect Tracker6

Integrations1

Lists4

Lives4

Meta Ads16

Metrics2

Orders1

P&L12

Personalization5

Products7

Promotion Snapshots3

Promotions13

Sample Review Intelligence (internal)2

Samples24

Seller Center5

Shared Dashboards4

Shop GMV2

Shop Health4

Shop Performance3

Shop Report1

Shops1

Social Intelligence30

Spark Codes1

Strategy (internal)2

Target Collabs3

Targets & Blacklist6

Usage Rights4

Video Intelligence3

Videos5

Weekly Report3

Workflows20

Creator Messages

Stage a draft reply on a creator conversation

Changed on Sep 19, 2026

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

Request

Base URL
https://api.reacherapp.com/public/v1
URL
https://api.reacherapp.com/public/v1/creator-messages/draft
Auth
API key in header x-api-key and API key in header x-shop-id

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