Sign in
Samples

Approve AI sample suggestions

Approve suggested sample requests on TikTok Shop — this ships real samples. Pass suggestion_ids (max 50) or all_qualifying: true (optionally with automation_id). Only suggestions with status='suggested' and verdict='qualifies' are approved; everything else comes back in skipped with a reason. Monthly sample quotas are enforced exactly as in the dashboard, and the automation's weekly approval caps (per product and shop total) apply as they do to its own approvals; over-cap suggestions stay suggested. A request TikTok no longer lists as pending becomes expired. Use X-Dry-Run: true first to preview. Requires read_write scope and Idempotency-Key.

post/samples/suggestions/approve

Headers

Idempotency-Keystring nullable
X-Dry-Runstring nullable

Request body

suggestion_idsinteger[] nullable

Suggestions to approve (max 50). Omit when using all_qualifying.

all_qualifyingboolean

Approve every suggested + qualifies suggestion (best-ranked first, up to 50 per call — call again for more). Mutually exclusive with suggestion_ids.

automation_idinteger nullable

Restrict all_qualifying to one automation.

Response

Successful Response

dry_runboolean required

Changes

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

Of the 28 revisions, 1 has no diff computed.