Track Segments

Remove people from a manual segment

You can remove users from a manual segment by ID. You are limited to 1000 customer IDs per request.

This endpoint requires people to have id attributes. If your workspace does not use id as an identifier, or you have not assigned people id values, you cannot remove people from manual segments using the API. Our user interface does not have this limitation. You can remove people from manual segments through the UI as a part of an automation workflow.

NOTE: You cannot remove people from data-driven segments using the API. See our documentation on segments for more information about segments.

post/api/v1/segments/{segment_id}/remove_customers

Request body

idsstring[] required

The customer IDs you want to remove from the segment.

Response

A successful request returns an empty object response.

Changes

No recorded changes to this endpoint across all 1 revision of this API.