Bulk SMS Campaigns

Send a message to a recipient list and create a campaign record for reporting.

Send Campaign

POST/v1/sms/campaigns

Option	Type	Required	Description
`to`	array	yes	Recipient phone numbers.
`from`	string	yes	Approved sender ID.
`message`	string	yes	Campaign SMS body.
`channel`	string	no	generic or dnd.
`reference`	string	no	External campaign reference.

{
  "to": ["08025671695", "08100000000"],
  "from": "NairaSMS",
  "message": "Hi {{name}}, your appointment is tomorrow.",
  "channel": "generic",
  "reference": "clinic_batch_42"
}

Wallet Billing

Developer campaigns debit the workspace wallet directly. The API calculates SMS parts and recipient count before debiting. Failed provider requests are refunded automatically.