CUcustomer
Track Segments

Remove people from a manual segment

Changed on

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

  • Base URL
    https://track.customer.io
  • URL
    https://track.customer.io/api/v1/segments/{segment_id}/remove_customers
  • Auth
    • HTTP bearer
    • or HTTP basic

Request body

idsstring[] required

The customer IDs you want to remove from the segment.

Response

A successful request returns an empty object response.

Changes

  • 7a1d33d191acRevision changes
    • info

      the endpoint scheme security Track-Bearer-Auth was added to the API

    • info

      added the non-success response with the status