Start or resume a campaign
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.
It is refused with 409 when the campaign is archived, its end date has passed, none of its email steps has content, or it has no mailbox that is active and connected. message says which.
Requires the CAMPAIGN_START 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 active.
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/start'{ "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"}List campaigns GET
The campaigns of your workspace, newest first. Archived campaigns are included; deleted ones are not.
Pause a campaign POST
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.