mailerpress/list-lists enumerates every MailerPress subscriber list on the site with per-list contact counts and the default-list flag.
The counts are what make it useful before a send.
At a glance
| Ability | mailerpress/list-lists |
| Toolset | MailerPress — toolset/mailerpress |
| Group | MailerPress › Lists |
| 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
A campaign targeted at a list with four contacts sends to four people and reports success. Nothing about the campaign says how many that is, and this is where the number lives.
The default-list flag matters for signups. Every opt-in that arrives without an explicit list target goes to the default, so that list accumulates everybody who signed up through a form that did not specify.
On many sites the default list is therefore the largest and the least deliberate.
Lists are one of the two classic targeting mechanisms, tags being the other. The difference is intent rather than mechanism: a list is something somebody subscribed to, a tag is something you decided about them.
Segments, on Pro installs, are a third approach and are evaluated live rather than stored.
Input
This ability takes no input.
What comes back
| Name | Type | What it is |
|---|---|---|
lists | array | Each list with its ID, name, contact count and default flag. |
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 lists do we have and how big are they?
It resolves to one call:
{
"ability": "mailerpress/list-lists",
"parameters": {}
}Worth knowing
- The contact count is not visible from a campaign. It lives here.
- The default list collects every unspecified signup.
- A list is subscribed to; a tag is applied.
- Read-only.
Related abilities
- MailerPress Set Default List — change where signups go
- MailerPress Count Campaign Audience — the reach of a targeting spec
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category