Skip to main content
DELETE
Bulk detach contacts from lists
Detach every combination of contact_ids × list_ids (up to 1000 contacts × 50 lists). Pairs that were not attached are reported in not_present. Requires the audience:write scope and is blocked for sandbox API keys.

Authorizations

Authorization
string
header
required

API key for authentication

Body

application/json

Bulk attach/detach contacts to/from lists. All combinations of contact_ids × list_ids are processed.

contact_ids
string<uuid>[]
required
Required array length: 1 - 1000 elements
list_ids
string<uuid>[]
required
Required array length: 1 - 50 elements

Response

OK

message
string
required
Example:

"Contacts detached from lists."

data
object
required