mailerpress/get-dashboard-contacts returns a contact-count time series for the past interval days, defaulting to thirty, bucketed per day.
It powers the list-health snapshot on the MailerPress dashboard.
At a glance
| Ability | mailerpress/get-dashboard-contacts |
| Toolset | MailerPress — toolset/mailerpress |
| Group | MailerPress › Dashboard |
| 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 total count says how big the list is. A series says whether it is growing, which is the question worth asking.
It counts contacts rather than distinguishing their status, so a list that is growing in total while losing subscribers looks healthy here. mailerpress/get-dashboard-contact-growth is the net figure that accounts for unsubscribes and bounces.
Reading both together is what separates real growth from accumulation: a list where the count rises and the net growth is flat is acquiring people who immediately unsubscribe.
Daily buckets make a sharp change visible. A step in the series usually corresponds to an import, and a step downwards to a bulk deletion.
The interval is the only parameter, so the window is the only thing to tune.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
interval | integer | No — defaults to 30 | How many days to cover. |
What comes back
| Name | Type | What it is |
|---|---|---|
series | array | Per-day contact counts. |
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:
Is our list growing?
It resolves to one call:
{
"ability": "mailerpress/get-dashboard-contacts",
"parameters": {
"interval": 90
}
}Worth knowing
- Counts contacts without regard to status.
- Read it with the growth series to separate growth from accumulation.
- A step in the series is usually an import or a bulk deletion.
- Read-only.
Related abilities
- MailerPress Dashboard Contact Growth — the net figure
- MailerPress List Contacts — the contacts themselves
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category