# Promotion Code

## Endpoints

### Create a promotion code

- [POST /v1/promotion_codes](https://docs.stripe.com/api/promotion_codes/create.md?api-version=2025-07-30.basil)

### Update a promotion code

- [POST /v1/promotion_codes/:id](https://docs.stripe.com/api/promotion_codes/update.md?api-version=2025-07-30.basil)

### Retrieve a promotion code

- [GET /v1/promotion_codes/:id](https://docs.stripe.com/api/promotion_codes/retrieve.md?api-version=2025-07-30.basil)

### List all promotion codes

- [GET /v1/promotion_codes](https://docs.stripe.com/api/promotion_codes/list.md?api-version=2025-07-30.basil)

A Promotion Code represents a customer-redeemable code for a [coupon](https://docs.stripe.com/api/promotion_codes.md?api-version=2025-07-30.basil#coupons). You can create multiple codes for a single coupon.

If you enable promotion codes in your [customer portal configuration](https://docs.stripe.com/docs/customer-management/configure-portal.md?api-version=2025-07-30.basil), 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.