mailerpress/list-campaign-unsubscribed-contacts returns a paginated list of contacts who unsubscribed as a result of a given batch.
Attributed to the batch, which is what makes it a diagnosis rather than a tally.
At a glance
| Ability | mailerpress/list-campaign-unsubscribed-contacts |
| Toolset | MailerPress — toolset/mailerpress |
| Group | MailerPress › Campaigns & Sending |
| Requires | AcrossAI Pro, plus MailerPress active on the site |
| Capability | manage_options |
| Safety | Read-only — changes nothing |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Pro 0.9.16 and later |
How it works
Unsubscribes attributed to one send say something specific: this campaign, to this audience, cost this many people. A site-wide unsubscribe count says nothing about which campaign caused it.
The usual causes are targeting rather than content — a campaign sent to a list that did not expect it produces unsubscribes from people who never wanted it, and the content was fine.
Comparing the rate across batches of the same campaign is the sharpest version of that test: identical content, different audiences, different unsubscribe rates.
These contacts are no longer reachable, and re-adding them is both a bad idea and, in most jurisdictions, unlawful. The list is for understanding rather than for action.
Per batch, with a wildcard search for checking one person.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
batch_id | integer | Yes | The send batch. |
search | string | No | Wildcard search on email or name. |
per_page | integer | No | Rows per page. |
What comes back
| Name | Type | What it is |
|---|---|---|
contacts | array | Contacts who unsubscribed from this batch. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
Who unsubscribed from that campaign?
It resolves to one call:
{
"ability": "mailerpress/list-campaign-unsubscribed-contacts",
"parameters": {
"batch_id": 91
}
}Worth knowing
- Attributed to a batch, which makes it diagnostic.
- The cause is usually targeting rather than content.
- Comparing batches of one campaign isolates the audience variable.
- These contacts must not be re-added.
Related abilities
- MailerPress Count Campaign Audience — check targeting before the next one
- MailerPress Dashboard Contact Growth — the net effect on the list
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category