Bulk global subscribe
Clears the global opt-out for a whole subscription list without having to enumerate every subscriber.
This endpoint has two modes:
- Explicit — supply
subscriber_idsand the request behaves exactly likePOST /subscriptions/subscribe, returning the affected subscribers synchronously. - Select-all — omit
subscriber_idsand supplyfrom_subscription_list_id. Every subscriber matchingsearchandfiltersin that list, minusexcept_ids, is queued for processing in the background and a Sidekiq job ID (jid) is returned immediately.
In select-all mode from_subscription_list_id is required and must be a subscription list UUID.
Authorizations
Token-based authentication. Use format: "Token token=<API_KEY>" where <API_KEY> is your API key
Body
UUIDs of specific subscribers to update. When present the request is handled synchronously and every other field is ignored.
UUID of the list whose members are being updated. Required when subscriber_ids is omitted. On the bulk_global_* endpoints this is a subscription list UUID; on the dynamic_bulk_* endpoints it is a dynamic list UUID.
Search term used to narrow the list's members. Defaults to * (all members) on the bulk_global_* endpoints.
URL-encoded JSON describing additional subscriber filters, as generated by the subscriber search in the Marketing dashboard. The decoded value is an array of filter groups, each group an array of {"field": ..., "op": ..., "terms": [...]} objects. Ignored by the dynamic_bulk_* endpoints, which use the filters saved on the dynamic list.
UUIDs of subscribers to exclude from the operation. Use this to express "select all except these".