Create promo code
Create a new promo code. Optionally restrict it to specific plans and a billing interval.
100% discounts are not supported. Percentage codes must be strictly less than 100% (discountValue < 10000 basis points). For full waivers, use an introductory offer on the plan instead. At checkout, any code — percentage or fixed amount — that would reduce the total below the currency’s minimum charge ($0.50 USD equivalent) is silently dropped.
2026-06-07. Send Commet-Version: 2026-06-07 with your request.Authorizations
Headers
API version used by this reference. Send this header to select this contract explicitly.
Body
1percentage, amount x <= 9007199254740991x <= 9007199254740991weekly, monthly, quarterly, semiannual, yearly, one_time x <= 9007199254740991Whether the code only applies to a customer's first purchase: one with no paid invoice above zero and no paid subscription. Defaults to false.