> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/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).