Sends the same SMS or MMS to every contact matching an audience filter — your groups, tags, profile fields, custom fields or tracking-link activity — instead of an explicit recipient list. Only contacts opted in to at least one of your groups, and not opted out, are ever included.
The audience is counted when you send: a filter matching nobody is rejected with 33039, and totalRecipients in the response is that count. Every id the filter names (grp_, tag_, con_, tlk_) and every custom-field label must belong to your account, otherwise 33041.
Personalize with merge tags such as {{contact_first_name}}, and track clicks per recipient with {{trackingLink "your.domain/code"}}.
Rate limit: shares the 1 request per minute budget of POST /v1/messaging/broadcast.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Unauthorized. 33001.
Payment Required. 33023 insufficient credits.
Forbidden. 33004 number not owned, 33011 sender blocked, 33020 account not configured, 33021 user not active, 33022 API not enabled.
Conflict. 33013 duplicate idempotency key.
Too Many Requests. 33002 rate limit exceeded, 33012 the audience exceeds your remaining daily quota.
Internal Server Error. 33000.