Contacts
Manage Segment Members
Add, remove, or replace the contacts that belong to a segment.
Manually manage which contacts belong to a segment. Intended for static segments (hand-picked contacts), but works on any segment you own. After any mutation the segment's cached contact_count is recalculated.
List members
GET
/io/contacts/segments/:id/membersReturns the contact UUIDs currently in the segment.
idstringpathrequiredSegment UUID.
{ "contactIds": ["8f1c…", "a922…"] }Mutate members
POST
/io/contacts/segments/:id/membersidstringpathrequiredSegment UUID.
actionstringbodyrequiredOne of
set, add, or remove. set replaces the entire membership set; add upserts; remove deletes the listed contacts.contactIdsstring[]bodyrequiredContact UUIDs (max 5000). Ids not owned by the caller are silently ignored.
{ "action": "set", "contactIds": ["8f1c…", "a922…"] }{ "count": 2 }