# Start or resume a campaign (/api-reference/campaigns/startCampaign)

## Start or resume a campaign

`POST https://app.alienmail.io/api/v1/campaigns/{id}/start`

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.

Authentication: `Authorization: Bearer <your API key>`

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | integer | yes | The 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. |

### Responses

**200**: The campaign, now `active`.

```json
{
  "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"
}
```

**401**: The API key is missing, wrong or revoked, its creator left the workspace or was suspended, or the workspace is archived or deleted.

**403**: The API key's role lacks the permission this endpoint needs.

**404**: The campaign, lead or mailbox was not found in your workspace.

**409**: The campaign, lead or mailbox is in a state that does not allow this. `message` says why.

**429**: More than 120 requests in a minute with this key, or a workspace limit on adding and removing leads.

Errors look like `{ "error": { "code": "not_found", "message": "Campaign not found" } }`. See the Errors page.