mailerpress/count-campaign-audience takes a targeting spec and returns the count of matching contacts, without creating a send batch.
It is the pre-send validation step.
At a glance
| Ability | mailerpress/count-campaign-audience |
| 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
Targeting is either classic — lists and tags — or a segment, and the two are mutually exclusive rather than combinable.
The count is the number that matters before a send, and it is the one nobody checks. A campaign targeted at a list that turned out to be empty sends to nobody and reports success; one targeted more broadly than intended reaches an audience nobody approved.
Both are visible here in one call, and neither is visible from the campaign.
Segment counts are evaluated live, so a segment-targeted campaign reaches whoever matches at send time rather than whoever matched when you checked. The count is indicative rather than a guarantee — which matters more the longer the gap between checking and sending.
No batch is created, so this is free to run as often as you like.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
lists | array | For classic targeting | List IDs. |
tags | array | For classic targeting | Tag IDs. |
segment_id | integer | For segment targeting | The segment. |
What comes back
| Name | Type | What it is |
|---|---|---|
count | integer | How many contacts match. |
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:
How many people would this campaign go to?
It resolves to one call:
{
"ability": "mailerpress/count-campaign-audience",
"parameters": {
"lists": [3]
}
}Worth knowing
- Classic targeting and segments are alternatives, not combinable.
- An empty audience sends to nobody and reports success.
- Segment counts are live, so they can change before the send.
- No batch is created.
Related abilities
- MailerPress Create Campaign Batch — the actual send
- MailerPress List Lists — the list IDs and their counts
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category