---
title: "Start, pause or archive an Auto Messages campaign"
method: PATCH
path: "/api/v0/accounts/{account_id}/auto-message-campaigns/{campaign_id}/status"
tags: ["auto-message-campaigns"]
---

# Start, pause or archive an Auto Messages campaign

`PATCH /api/v0/accounts/{account_id}/auto-message-campaigns/{campaign_id}/status`

## Request

- Base URL: `https://omapi.onlymonster.ai`
- URL: `https://omapi.onlymonster.ai/api/v0/accounts/{account_id}/auto-message-campaigns/{campaign_id}/status`
- Auth: API key in header `x-om-auth-token`

**Rate limit:** 5 requests per second

Asking for the state the campaign is already in is accepted and does not change the campaign, but it is not free: the change is carried out again, which is how a change that did not complete is retried. If the answer is `502`, repeat the same request to complete the change; after a `204` there is nothing to repeat. Every request, a repeat included, counts toward the rate limit.

**Required permission:** `auto_messages.edit`

## Path parameters

- `account_id` string, required
- `campaign_id` string, required

## Request body

- object: State to move the campaign to. `active` — the campaign reacts to its trigger again. `paused` — the campaign stops reacting and keeps what it already queued. `archived` — the campaign stops for good and its pending queue is cleared.
  - `status` 'active' | 'paused' | 'archived', required

## Response `204`

The status was changed and the change was confirmed.

## Other responses

- `400`: The requested state is not one of the three, or the campaign is recalling what it sent and cannot change state at all.
- `403`: The API key lacks the permission this endpoint requires, or the request is outside what the organisation or the API key can access.
- `404`: The campaign does not exist for this account.
- `502`: The change did not complete. Repeating the request is safe and is how the change is retried. On a stop the campaign already reads as stopped and starts no new sends; messages already on their way may still be delivered.

## Changes

- **2026-11-03** `20f58411c6c5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/onlymonster/apis/om-api-service/changes/api/v0/accounts/:account_id/auto-message-campaigns/:campaign_id/status/patch.md)

---

[API](https://skmtc.dev/onlymonster/apis/om-api-service.md) - [All operations](https://skmtc.dev/onlymonster/apis/om-api-service/llms.txt) - [OpenAPI document](https://skmtc.dev/onlymonster/apis/om-api-service/revisions/0003edb0288a?raw)