Manage segments over API
EARLY ACCESSYou can manage segments programmatically through the Customer Profiles API (opens in a new tab).
Use the API to create, retrieve, update, and delete segments as part of your automated workflows. To manage segments through the web interface, see Create a segment and Manage segments.
Available operations
The following operations are available:
| Endpoint | Description |
|---|---|
| Create a segment (opens in a new tab) | Create a new segment. |
| Get segments (opens in a new tab) | Get all segments. |
| Get segment (opens in a new tab) | Get a specific segment. |
| Update segment (opens in a new tab) | Update a segment. |
| Delete segment (opens in a new tab) | Delete a segment. |
| Get persons in a segment (opens in a new tab) | Get persons in a segment by ID. |
Use cases
Common use cases for managing segments through the API include:
- Automated segment creation - Create segments based on external data sources or scheduled processes
- Dynamic segment updates - Modify segment rules based on business logic or user behavior patterns
- Integration workflows - Sync segments with external CRM or marketing automation platforms
- Bulk operations - Manage multiple segments programmatically for large-scale campaigns
For detailed API documentation including request parameters, response formats, and code examples, see the Customer Profiles API documentation (opens in a new tab).