Skip to main content
DELETE
Bulk unsubscribe contacts from topics
Remove every combination of contact_ids × topic_ids. Pairs that did not exist are ignored, so unsubscribed can be lower than total_pairs. Requires the audience:write scope and is blocked for sandbox API keys.
This DELETE carries a request body. Most HTTP clients support that, but some need it enabled explicitly — the same applies to bulk detach contacts from lists.

Authorizations

Authorization
string
header
required

API key for authentication

Body

application/json

Bulk subscribe/unsubscribe contacts to/from topics. All combinations of contact_ids × topic_ids are processed.

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

Response

OK

message
string
required
Example:

"Contacts unsubscribed from topics."

data
object
required