Campaigns and opt-outs

One message to many people, each with their own details filled in, sent from the console.

Campaigns are made in the console, on Campaigns: pick your contacts (groups, all of them, or a pasted list), write the text with {{variables}} such as {{first_name}} filled from each contact's fields, and send now or schedule it up to 31 days ahead. The console shows the recipients, the parts and the total cost before you confirm.

Campaign messages in the API#

Each recipient becomes an ordinary message. It appears in GET /v1/messages with a campaign_id, is billed per part like any other, and sends webhooks to your callback URL. Campaign messages queue behind messages sent through the API, so a large campaign doesn't delay your sign-in codes and order updates.

Cancelling and deleting#

• Cancel a scheduled or sending campaign: messages not yet sent stop and are refunded; those already sent can't be recalled.
• Delete a completed or cancelled campaign to take it off your list. Its messages stay in Messages and its charges in Billing, so your statistics don't change.

Opt-outs#

Numbers on your opt-out list are skipped by every campaign, and the console tells you how many were left out. Add numbers to it by hand or in bulk when people ask you to stop. Messages you send through the API to a single number aren't checked against the list: honouring it there is up to your system.