Skip to main content

Set Promotion Status

POST 

/promotions/:promotionId/status

Pause, resume or cancel one of the brand's own promotions, applied at once with no preview. The promotion's statusActions lists what it accepts now; a cancel cannot be undone. Asking for the status it already has is answered NotApplied and sends nothing. Requires promotions.write.

Request and response fields at a glance
  • Path parameters: promotionId (integer, required).
  • Request body (application/json): brandId (integer, required), status (string, required).
  • 200 response (application/json): batchId (string, required), promotionId (integer or null, required), steps (array, required), results (array, required), summary (object, required).

Request​