# NewPromotionInput

input type

Create-input for a Promotion. The tenant (org group) is derived SERVER-SIDE from the principal — NEVER supplied here; free_gift/free_shipping effects refuse by the NAMED deferral gate BEFORE the generic parse; every scope/conditions/effect ref is tenant-scoped server-side and must be ACTIVE; startAt stamps NOW when omitted; priority/exclusive/couponGated default 100/false/false.

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `caption` | [String](/types/#scalars) | no | Optional: when omitted the per-type default applies — the merchant code when given, else 'Promotion'; when supplied it must be non-blank. |
| `effect` | [PromotionEffectInput](/types/PromotionEffectInput/) `PromotionEffectInput!` | yes | No further notes. |
| `scope` | [PromotionScopeInput](/types/PromotionScopeInput/) | no | No further notes. |
| `productScope` | [PromotionProductScopeInput](/types/PromotionProductScopeInput/) | no | No further notes. |
| `cartConditions` | [PromotionCartConditionsInput](/types/PromotionCartConditionsInput/) | no | No further notes. |
| `startAt` | [String](/types/#scalars) | no | The window start (UTC ISO-8601) — omitted ⇒ stamped NOW; a FUTURE instant is the advance-scheduling arm. |
| `endAt` | [String](/types/#scalars) | no | The window end (half-open) — omitted ⇒ evergreen; must lie strictly after the (stamped) start. |
| `priority` | [Int](/types/#scalars) | no | Resolution ordinal 0..1000000 — omitted ⇒ 100. |
| `exclusive` | [Boolean](/types/#scalars) | no | Omitted ⇒ false; TRUE refuses a combinableGroup (incoherent). |
| `combinableGroup` | [String](/types/#scalars) | no | No further notes. |
| `maxDiscountPerLineMinor` | [Int](/types/#scalars) | no | No further notes. |
| `maxDiscountPerOrderMinor` | [Int](/types/#scalars) | no | No further notes. |
| `totalRedemptionsCap` | [Int](/types/#scalars) | no | No further notes. |
| `couponGated` | [Boolean](/types/#scalars) | no | Omitted ⇒ false; TRUE = fires ONLY through an attached trigger Coupon. |
| `code` | [String](/types/#scalars) | no | No further notes. |

## Used by

- [createPromotion](/reference/promotion/createPromotion/)