# 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](/reference/promotion/createPromotion/) | mutation | Create a new promotion — an automatic price rule at your organization. |
| [deactivatePromotion](/reference/promotion/deactivatePromotion/) | mutation | Deactivate a promotion — an automatic price rule — it stops being usable but keeps its history and can be reactivated. |
| [doomPromotion](/reference/promotion/doomPromotion/) | mutation | Permanently retire a promotion — an automatic price rule. |
| [promotion](/reference/promotion/promotion/) | query | Look up one record — a promotion — an automatic price rule. |
| [promotions](/reference/promotion/promotions/) | query | The promotion list — each entry is a promotion — an automatic price rule. |
| [reactivatePromotion](/reference/promotion/reactivatePromotion/) | mutation | Reactivate a promotion — an automatic price rule — bring a deactivated record back into use. |
| [updatePromotion](/reference/promotion/updatePromotion/) | mutation | Edit a promotion — an automatic price rule — change its details. |