Run a campaign

Sends an approved template to many numbers, now or at scheduled_at
(without a UTC offset it is Bangladesh time). The upper-bound cost is held from
your balance and settled when the campaign is sent; cancelling releases it.

Recipients — at most 1,000 per call (split larger lists into several
campaigns), as a JSON recipients array or a CSV file (multipart):

  • static template: ["01712345678", "01812345678"]
  • dynamic template: [{"to": "01712345678", "values": ["Rahim"]}] — one value per ##variable##, in order
  • CSV: column 1 = number, following columns = variable values; header row skipped

Invalid / duplicate rows are skipped (skipped_rows). Send an Idempotency-Key
header to make retries safe — a repeat within 24 h returns the original campaign.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
integer
required
string

Your label; returned as name and as client_reference in the message log.

string

Alias of name, used when name is omitted.

string
recipients
array
required
length ≤ 1000
recipients*
Headers
string
length ≤ 120
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Responses

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json