Skip to main content

Preview Create Promotion

POST 

/promotions/preview

Check and price a seller promotion without creating it. 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
  • 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): action (string, required), promotionId (integer or null, required), steps (array, required), commitment (object, required), listings (array, required), summary (object, required), warnings (array, required).

Request​