Create a promotion

Requires name, discount, channels and product_ids. Without starts_at the promotion starts now (active); with draft: true it is saved as draft and nothing reaches the channels. Each invalid field answers 422 with its own message and param (discount.value, product_ids[2], variant_ids.prod_…); unknown_channel names the channel, discount_exceeds_price the product a fixed discount prices out, 404 product_not_found the missing products. A promotion that isn't a draft must reach something: 422 channel_not_connected (param = channels[n]) for a channel the store hasn't connected, 422 promotion_reaches_nothing when none of the products is listed on the chosen channels (the storefront always counts). Refused with promotion_conflict when a product is already in another live promotion, and promotion_limit_reached beyond the plan's running promotions. Recorded in the action log (undo = stop it). Required scope: promotions:write.

Header Parameters

Response Body