Skip to main content
POST
Bulk attach contacts to lists
Attach every combination of contact_ids × list_ids (up to 1000 contacts × 50 lists). Existing pairs are reported in already_attached. 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 attached to lists."

data
object
required