Skip to main content

Preview Edit Promotion

POST 

/promotions/:promotionId/edit/preview

Check a change to one of the brand's own promotions: its end, budget, terms or listings, as editableFields allows. Nothing is sent to the marketplace: the preview resolves each SKU, reads the caps, checks stock, deadlines and the marketplace's own rules, and prices every listing. A loss or a below-target margin is flagged, never refused. Requires promotions.write.

Request and response fields at a glance
  • Path parameters: promotionId (integer, required).
  • Request body (application/json): brandId (integer, required), budget (number or null), endsAt (string or null), terms (object), addListings (array), removeListings (array).
  • 200 response (application/json): action (string, required), promotionId (integer or null, required), steps (array, required), commitment (object, required), listings (array, required), summary (object, required), warnings (array, required).

Request​