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).