# Pause a campaign (/api-reference/campaigns/pauseCampaign)

## Pause a campaign

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

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.

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 `paused`.

```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.