> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/promotions/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# Promotions API

A *promotion* is composed of a condition that a customer can satisfy, such as increasing their cart value above a certain amount or adding an item to their cart.

After the customer satisfies the condition, an action takes place, such as a free item being added to the cart or a discount applying itself to the order total.

To learn more about promotions, consult the [Promotions Overview](/developer/docs/admin/catalog-and-inventory/promotions).

> Build amazing commerce solutions powered by the BigCommerce platform


## API Docs

- Admin Management: Promotions > Coupon Codes Bulk [List Coupon Codes](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/promotions/coupon-codes-bulk/get-promotion-codes.md)
- Admin Management: Promotions > Coupon Codes Bulk [Delete Multiple Coupon Codes](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/promotions/coupon-codes-bulk/delete-coupon-codes.md)
- Admin Management: Promotions > Coupon Codes Bulk [Generate Multiple Coupon Codes](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/promotions/coupon-codes-bulk/generate-promotion-codes-batch.md)
- Admin Management: Promotions > Coupon Codes Bulk [Reschedule Multiple Coupon Codes](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/promotions/coupon-codes-bulk/reschedule-promotion-codes.md)
- Admin Management: Promotions > Coupon Codes Single [Create Coupon Code](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/promotions/coupon-codes-single/create-promotion-code.md)
- Admin Management: Promotions > Coupon Codes Single [Get Coupon Code](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/promotions/coupon-codes-single/get-coupon-code-by-code.md)
- Admin Management: Promotions > Coupon Codes Single [Delete Coupon Code](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/promotions/coupon-codes-single/delete-coupon-code-by-code.md)
- Admin Management: Promotions > Coupon Codes Single [Delete Coupon Code by ID](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/promotions/coupon-codes-single/delete-coupon-code.md)
- Admin Management: Promotions > Promotions Bulk [List Promotions](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/promotions/promotions-bulk/get-promotions.md)
- Admin Management: Promotions > Promotions Bulk [Delete Multiple Promotions](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/promotions/promotions-bulk/delete-promotions.md)
- Admin Management: Promotions > Promotions Bulk [Archive Multiple Promotions](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/promotions/promotions-bulk/archive-promotions.md)
- Admin Management: Promotions > Promotions Bulk [Unarchive Multiple Promotions](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/promotions/promotions-bulk/unarchive-promotions.md)
- Admin Management: Promotions > Promotions Single [Create Promotion](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/promotions/promotions-single/create-promotion.md)
- Admin Management: Promotions > Promotions Single [Get Promotion](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/promotions/promotions-single/get-promotion.md)
- Admin Management: Promotions > Promotions Single [Update Promotion](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/promotions/promotions-single/update-promotion.md)
- Admin Management: Promotions > Promotions Single [Delete Promotion](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/promotions/promotions-single/delete-promotion.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/promotions/openapi.json)
- [OpenAPI YAML](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/promotions/openapi.yaml)