mailerpress/list-campaigns returns a paginated list of MailerPress campaigns, filterable by status.
The status values are the campaign lifecycle: draft, scheduled, in progress, sent.
At a glance
| Ability | mailerpress/list-campaigns |
| 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
In-progress is the one worth watching. A send is a batch: MailerPress splits the recipients into chunks and hands them to Action Scheduler, which dispatches them over time. So a send is a process with a state rather than an event that happened.
So a campaign sitting in progress is either mid-send or stalled, and nothing in the status distinguishes the two — mailerpress/get-campaign-batches and mailerpress/get-batch-chunks do.
Draft campaigns accumulate. A site that has been running for a while has dozens, most of them abandoned, and the list is where that becomes visible.
The listing is metadata. The content — both versions of it — comes from mailerpress/get-campaign and mailerpress/get-campaign-send-html.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
status | string | No | draft, scheduled, in_progress or sent. |
per_page | integer | No | Rows per page. |
page | integer | No | Page number. |
What comes back
| Name | Type | What it is |
|---|---|---|
campaigns | array | Each campaign with its ID, name, subject and status. |
total | integer | How many matched. |
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:
What campaigns do we have?
It resolves to one call:
{
"ability": "mailerpress/list-campaigns",
"parameters": {}
}Worth knowing
- In-progress covers both mid-send and stalled. The batch reads tell them apart.
- Draft campaigns accumulate and nothing prunes them.
- Content is a separate call, in two versions.
- Read-only.
Related abilities
- MailerPress Get Campaign — one campaign
- MailerPress Get Campaign Batches — the send state
- MailerPress List Sent Campaigns — the historical archive
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category