Pause a campaign
Stops sending: emails that were waiting to go out are taken off the queue. Start the campaign again to resume; each lead then continues with their next email. A campaign that is already paused is returned unchanged.
Only an active campaign can be paused. Any other status returns 409.
Requires the CAMPAIGN_STATUS_UPDATE permission.
apiKeyAuthorizationBearer <token>An API key of your workspace, from Workspace settings, Integrations. Each key has a role, and the role decides which endpoints it may call.
id*integerThe campaign id: the number in the campaign URL in Alienmail, or id from the campaign list. An id that is not a campaign of your workspace returns 404.
The campaign, now paused.
application/json- response
id*integerThe campaign id, as in the campaign URL in Alienmail.
name*stringstatus*string"draft""active""paused""completed""archived"leadCount*integerLeads in the campaign. Removed leads are not counted.
sentCount*integerEmails the campaign has sent, bounced ones included.
lastSentAt*|nullcreatedAt*stringdate-timeupdatedAt*stringdate-timecurl -X POST 'https://app.alienmail.io/api/v1/campaigns/42/pause'{ "id": 42, "name": "Q1 outreach", "status": "active", "leadCount": 180, "sentCount": 412, "lastSentAt": "2026-11-13T09:30:00.000Z", "createdAt": "2026-11-13T09:30:00.000Z", "updatedAt": "2026-11-13T09:30:00.000Z"}Start or resume a campaign POST
Starts a `draft` campaign, resumes a `paused` one, or restarts a `completed` one. Leads that were waiting become `active` and their next email is queued. A campaign that is already `active` is returned unchanged, so the call is safe to repeat.
List leads GET
The leads of a campaign, newest first. Leads that were removed from the campaign are not listed.