Skip to content

Promotion Code ​

A Promotion Code represents a customer-redeemable code for an underlying promotion. You can create multiple codes for a single promotion.

If you enable promotion codes in your customer portal configuration, then customers can redeem a code themselves when updating a subscription in the portal. Customers can also view the currently active promotion codes and coupons on each of their subscriptions in the portal.

Endpoints ​

Create a promotion code ​

  • POST /v1/promotion_codes

Update a promotion code ​

  • POST /v1/promotion_codes/:id

Retrieve a promotion code ​

  • GET /v1/promotion_codes/:id

List all promotion codes ​

  • GET /v1/promotion_codes

Events ​

  • promotion_code.created Occurs whenever a promotion code is created.

  • promotion_code.updated Occurs whenever a promotion code is updated.

Stripe API Reference - Self-contained docs reference, refreshed 2026-05-18