Skip to main content
All endpoints require authentication.

Endpoints

List Campaigns

GET /api/campaigns

Create Campaign

POST /api/campaigns
Body
FieldTypeRequiredDescription
namestringYesInternal label
typestringYesbroadcast, drip, trigger, survey
templateIdnumberYesApproved WhatsApp template ID
audiencestringYesall or a contact list ID
schedulestringNoimmediate, scheduled, or recurring
scheduledAtstringNoISO datetime for scheduled sends
templateParamsobjectNoDynamic placeholder values

Get Campaign

GET /api/campaigns/:id
Returns campaign details including send stats (sent, delivered, read, failed).

Send Campaign

POST /api/campaigns/send
Body
FieldTypeDescription
campaignIdnumberID of the campaign to send
Triggers immediate dispatch of the campaign to all targeted contacts.

Campaign Statuses

StatusDescription
draftCreated but not sent
scheduledWill send at a future time
activeCurrently running
pausedPaused mid-run
completedFinished sending
failedEncountered errors