---
title: "Recall what an Auto Messages campaign has sent"
method: POST
path: "/api/v0/accounts/{account_id}/auto-message-campaigns/{campaign_id}/unsend"
tags: ["auto-message-campaigns"]
---

# Recall what an Auto Messages campaign has sent

`POST /api/v0/accounts/{account_id}/auto-message-campaigns/{campaign_id}/unsend`

## Request

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

**Rate limit:** 5 requests per second

The campaign stops sending, its queue is cleared, and the messages it delivered within the last 24 hours are taken back out of the fans' chats. Anything older stays: the platform allows no recall beyond that window.

**This cannot be undone and it is not limited to campaigns this API created.** Any campaign of the account can be recalled, including one a member built in the panel.

Unlike a status change, repeating this request is not always safe: a campaign that is already recalling refuses it. If the answer is `502`, read the campaign before repeating — recalling or recalled means the recall started and finishes on its own, while active or paused means it never started and only a repeat performs it. Reading the campaign needs `auto_messages.view` in addition to `auto_messages.edit`.

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

## Path parameters

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

## Response `204`

The recall was accepted: the campaign stops sending and takes back what it can.

## Other responses

- `400`: The campaign is not in a state a recall can start from: it is already recalling, or it is archived, or it opens a Mimic chat and sends nothing of its own. One code covers every cause; read the campaign to tell which.
- `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`: Unlike a status change, this answer is not an invitation to repeat the request blindly: the campaign stops sending the moment the recall is accepted, before the recall itself is confirmed, so a repeat against a campaign that did start meets the recall branch and is refused. Read the campaign to tell the two apart. Recalling or recalled means it started, and it is finished without further requests. Active or paused means the request never reached the campaign, and repeating it is the only way the recall happens.

## 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/unsend/post.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)