set_campaign_status
Activate, pause or complete a campaign.
›Pause the Agency Q3 campaign right now — the bounce rate on the last import looks wrong.
What it does
Moves a campaign between `draft`, `active`, `paused` and `completed`. Only `active` campaigns are picked up by the pipeline, which makes this the on/off switch for outbound.
Pausing takes effect at the next pipeline pass. In-flight leads keep their scheduled positions in the sequence, so unpausing resumes the sequence rather than restarting it — nobody gets touch one twice because you paused for a week.
This is the tool to reach for the moment something looks wrong. Pause first, diagnose second.
Marking a campaign `completed` rather than leaving it paused is worth doing when a sequence has genuinely finished. Paused campaigns accumulate, and a list of nine paused campaigns hides the one you actually meant to restart. Completed is a statement that this one is done, not deferred.
Activating is the one status change worth doing deliberately rather than in passing. A campaign moving from draft to active is the moment enrolled leads become send-eligible, so read the steps back with `get_campaign` first — it is the last checkpoint before real people receive the copy.
Parameters
| Name | Type | Notes |
|---|---|---|
| campaign_id * | string | From `list_campaigns`. |
| status * | enum | `draft`, `active`, `paused` or `completed`. |
* required · Maps to PATCH /api/campaigns/:id
What comes back
The updated campaign.
The thing people get wrong
Pausing is not instant cancellation of a run already underway. A pass mid-flight completes; the pause applies from the next one.
Use it with
More campaigns tools
See all 22 tools and the connection string on the MCP server page.