> 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

> **Note**
>
> #### Exclusive enterprise feature
>
> The Customer Segmentation API is available to enterprise customers. If you would like to become an enterprise customer, please contact your BigCommerce Customer Service Manager or our support team.

The [Promotions API](/developer/docs/admin/catalog-and-inventory/promotions) lets you create exponentially more promotions and granular targeting rules than what you can do in the store control panel UI alone.

Learn more about [targeting a segment with a promotion](/developer/docs/admin/customers/customer-segmentation/user-guide#targeting-a-segment-with-a-promotion).

## Resources

### Articles

* [Customer Segmentation API Guide](/developer/docs/admin/customers/customer-segmentation/user-guide)
* [Customer Segmentation API Overview](/developer/docs/admin/customers/customer-segmentation)
* [Definitions and Logical Relationships](/developer/docs/admin/customers/customer-segmentation/definitions-and-relationships)
* [Promotions standard editor](https://support.bigcommerce.com/s/article/Advanced-Promotions#creating) (Support Center)

### Customer Segmentation reference

* [Customer Segmentation V3 API Reference Overview](/developer/api-reference/rest/admin/management/customer-segmentation)
* [Create segments](/developer/api-reference/rest/admin/management/customer-segmentation/segments/segments-post-request)
* [Create shopper profiles](/developer/api-reference/rest/admin/management/customer-segmentation/shopper-profiles/shopper-profiles-request)
* [Add shopper profiles to a segment](/developer/api-reference/rest/admin/management/customer-segmentation/shopper-profiles-for-a-segment/post-shopper-profile)
* [Update Segments](/developer/api-reference/rest/admin/management/customer-segmentation/segments/put-segment-objects)
* [Remove shopper profiles from a segment](/developer/api-reference/rest/admin/management/customer-segmentation/shopper-profiles-for-a-segment/delete-shopper-profile)
* [Delete segments](/developer/api-reference/rest/admin/management/customer-segmentation/segments/delete-store-segment)
* [Get all shopper profiles in a segment](/developer/api-reference/rest/admin/management/customer-segmentation/shopper-profiles/get-shopper-list)
* [Get all segments for a shopper profile](/developer/api-reference/rest/admin/management/customer-segmentation/segments-for-a-shopper-profile/get-list-shopper-profile)

### Customers reference

* [Create customers](/developer/api-reference/rest/admin/management/customers/v3/create-customers)
* [Get customers](/developer/api-reference/rest/admin/management/customers/v3/get-customers)