subscriptions

Bulk subscribe a dynamic list

The dynamic list counterpart to bulk global subscribe.

  • Explicit — supply subscriber_ids and the request behaves exactly like POST /subscriptions/subscribe.
  • Select-all — omit subscriber_ids and supply from_subscription_list_id, which here is a dynamic list UUID. The job resolves the list's current membership, subtracts except_ids, and clears the global opt-out on the rest. A Sidekiq job ID (jid) is returned immediately.

A dynamic list's membership is defined by the filters saved on the list itself, so any filters sent with the request is ignored in select-all mode.

post/subscriptions/dynamic_bulk_subscribe

Request

  • Base URL: https://api.paubox.com/v1/marketing
  • URL: https://api.paubox.com/v1/marketing/subscriptions/dynamic_bulk_subscribe
  • Auth: API key in header authorization

Request body

subscriber_idsstring[]

UUIDs of specific subscribers to update. When present the request is handled synchronously and every other field is ignored.

from_subscription_list_idstring

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.

searchstring

Search term used to narrow the list's members. Defaults to * (all members) on the bulk_global_* endpoints.

filtersstring

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.

except_idsstring[]

UUIDs of subscribers to exclude from the operation. Use this to express "select all except these".

Response

A job ID in select-all mode, or the affected subscribers when subscriber_ids was supplied.

errorsstring

Error message, present only when the operation failed

Changes

No recorded changes to this operation across all 1 revision of this API.