Skip to main content

Create Promotion

POST 

/promotions

Create a seller promotion on one of the brand's accounts, with its listings where the kind takes them. Preview it first with previewCreatePromotion. A promotion the marketplace already holds with the same kind, window and terms is refused. The write is planned again the way its preview was, then sent. One outcome per listing is recorded before anything is sent, each is settled by the marketplace's answer, and the listings are read back. A listing the checks refuse is not sent while the others are; when every listing is refused the request is a 400. When the preview lists a step with isRiskOfLoss, send isRiskAcknowledged: true. A second write to the same promotion while one is running is a 409 conflict. Amazon promotions are read-only: a write on one is a 403. Requires promotions.write.

Request and response fields at a glance
  • Request body (application/json): brandId (integer, required), saleChannelId (integer, required), kind (string, required), subKind (string or null), name (string or null), startsAt (string, required), endsAt (string, required), budget (number or null), terms (object, required), extra (object), listings (array).
  • 200 response (application/json): batchId (string, required), promotionId (integer or null, required), steps (array, required), results (array, required), summary (object, required).

Request​