> 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.

# Definitions and Logical Relationships

> **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.

## Segment

An entity that classifies shoppers into groups or buckets, referred to as **segments**.

## Manual segment

A collection of shoppers that a merchant or application has grouped together using the API. Manual segments are not a distinct entity in our API; they are a subset of **segments**.

## Shopper profile

An entity that represents a registered **customer**. Current plans for future releases include supporting **shopper profiles** for **guest** customers.

## Customer

An existing entity that represents a shopper who is registered with the store. In the Customer Segmentation API documentation, assume that **customers** are signed in to the subject storefront. For more on the **customer** entity, see the public [Customers API reference](/developer/api-reference/rest/admin/management/customers/v3).

## Guest

A shopper who is not signed in to the subject storefront.

A **guest** may or may not be a registered **customer**, but because they are not signed in, your application doesn't know their registration status.

## Promotion

A way to give discounts based on whether the shopper meets specific criteria, such as ordering a certain amount, purchasing certain brands, being a repeat customer, or being associated with a **shopper profile** that belongs to a **segment**.

For more on using **promotions** with **segments**, see [Targeting a segment with a promotion](/developer/docs/admin/customers/customer-segmentation/user-guide#targeting-a-segment-with-a-promotion). For more on the **promotion** entity, see the [Promotions documentation](/developer/docs/admin/catalog-and-inventory/promotions).

## Summary of entity relationships

### Many-to-many

* Segments and shopper profiles
* Segments and promotions

### One-to-one

* Shopper profiles and customers

### Other entity relationships

Relationships that don't currently involve the Customer Segmentation API:

* Many-to-many: guests and promotions

Relationships that don't yet exist:

* Shopper profiles and guests

## Resources

### Articles

* [Customer Segmentation API Overview](/developer/docs/admin/customers/customer-segmentation)
* [Customer Segmentation API Guide](/developer/docs/admin/customers/customer-segmentation/user-guide)
* [Promotions and Customer Segmentation](/developer/docs/admin/customers/customer-segmentation/promotions-api)
* [Promotions API documentation](/developer/docs/admin/catalog-and-inventory/promotions)

### 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)