Promotion
The Promotion family — 7 operations.
A promotion is an automatic discount rule — percent off, an amount off, a fixed unit price, buy some and get some, or a bundle deal — with where it applies (channels, locations, organizations, customer price groups), which product lines it matches (a rule, hand-picked inclusions and exclusions, or a collection; nothing set means every product line) and the cart conditions that must hold. It fires inside its date window (no end means evergreen); when several match, the lower priority number applies first, and promotions never stack on a line unless they share a combinable group — an exclusive one blocks its lines outright. Create it here, keep the rule current and pause it when it should stop; a coupon-gated promotion fires only through a coupon that names it. The code is a free reference of your own, not required to be unique.
Operations
| Operation | Kind | What it does |
|---|---|---|
| createPromotion | mutation | Create a new promotion — an automatic price rule at your organization. |
| deactivatePromotion | mutation | Deactivate a promotion — an automatic price rule — it stops being usable but keeps its history and can be reactivated. |
| doomPromotion | mutation | Permanently retire a promotion — an automatic price rule. |
| promotion | query | Look up one record — a promotion — an automatic price rule. |
| promotions | query | The promotion list — each entry is a promotion — an automatic price rule. |
| reactivatePromotion | mutation | Reactivate a promotion — an automatic price rule — bring a deactivated record back into use. |
| updatePromotion | mutation | Edit a promotion — an automatic price rule — change its details. |