List campaigns
The campaigns of your workspace, newest first. Archived campaigns are included; deleted ones are not.
Requires the CAMPAIGN_READ 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.
status?stringOnly campaigns with this status.
"draft""active""paused""completed""archived"search?stringOnly campaigns whose name contains this text.
limit?integerItems per page, 1 to 100. Default 25. A number outside that range is rounded to the nearest limit (0 is 1, 500 is 100) and a fraction rounded down; anything that is not a number is the default.
1 <= value <= 10025cursor?stringThe nextCursor of the previous page. Anything else returns 400.
A page of campaigns.
application/json- response
data*array<>nextCursor*|Pass as cursor to get the next page. null on the last page.
curl -X GET 'https://app.alienmail.io/api/v1/campaigns'{ "data": [ { "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" } ], "nextCursor": null}Overview
Every endpoint of the Alienmail REST API, with a playground to try it.
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.