Enroll Listings
POST/promotions/:promotionId/enroll
Enroll listings in a promotion at the given prices, or change the price of listings already in it. 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
- Path parameters:
promotionId(integer, required). - Request body (application/json):
brandId(integer, required),listings(array, required),isRiskAcknowledged(boolean). - 200 response (application/json):
batchId(string, required),promotionId(integer or null, required),steps(array, required),results(array, required),summary(object, required).