Skip to main content
POST
Bulk subscribe contacts to topics
Subscribe every combination of contact_ids × topic_ids (up to 1000 contacts × 50 topics). Pairs that already exist are reported in already_subscribed. Requires the audience:write scope and is blocked for sandbox API keys.
The contacts array returned by bulk create contacts gives you the ids to pass here, so you can import and subscribe without a lookup in between.

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 subscribed to topics."

data
object
required