Skip to main content

Launch a campaign (confirm-gated + billing-enforced)

POST 
/v1/campaigns/:campaign_id/send

Launch a campaign to its audience.

This is real, mass, billable outbound with no sandbox, so it sits behind two guards. Billing comes first: an organization that is suspended or in its grace period is refused with a 403. Then confirmation: called without confirm: true, the endpoint sends nothing and returns a summary of what would go out plus any unmet prerequisites, so you can check the audience size and template before committing. Call it again with confirm: true to actually launch.

On launch the send is batched through the background queue rather than run inline, so the response returns immediately while delivery proceeds — poll the campaign to watch its status.

Requires the campaigns:send scope.

Request​

Responses​

Successful Response

Last updated on