Sign in
GMV Max

Sync specific spark codes to TikTok

Synchronously authorise the listed spark codes against the shop's TikTok Business ad account. Each code fires one TikTok /tt_video/authorize/ call:

  • On success → code's sync_status flips to synced.
  • On TikTok QPS / rate-limit → code is left pending so the offline CRJ retries it; the response counts this in queued.
  • On hard error → failed with the error string.

Up to 100 codes per request. Shops without an active TikTok Business connection return 422 TIKTOK_NOT_CONNECTED. Single shop only.

post/gmv-max/spark-codes/sync

Headers

Idempotency-Keystring nullable
X-Dry-Runstring nullable

Request body

spark_codesstring[] required

Up to 100 spark codes to sync in one request. Each code fires one TikTok /tt_video/authorize/ call; rate-limited codes are left as pending so the offline CRJ picks them up. Whitespace is stripped; blank or duplicate entries are rejected with 422.

Response

Sync attempted; see results for per-code outcome.

{"stackTrail":"paths:/gmv-max/spark-codes/sync:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes

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