mailerpress/get-dashboard-contact-growth returns net contact-growth over interval days: subscribed plus confirmed, minus unsubscribed and hard-bounced.
That arithmetic is what makes it the honest figure.
At a glance
| Ability | mailerpress/get-dashboard-contact-growth |
| 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 raw contact count rises whenever anybody signs up and never falls, because unsubscribed and bounced contacts stay in the database. So the raw count of a declining list still rises.
This subtracts them, which means it can go negative — and a negative month is the signal worth acting on.
Hard bounces in particular are worth watching separately from unsubscribes. A rising bounce rate is a list-quality or a deliverability problem, and it damages sender reputation for everything else the site sends.
Unsubscribes concentrated after one campaign point at that campaign, which mailerpress/list-campaign-unsubscribed-contacts confirms per batch.
Confirmed is counted as growth because a pending contact who confirms becomes reachable — which is a real gain even though no new person arrived.
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 |
|---|---|---|
growth | array | Net growth over the interval. |
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 the list actually growing or just getting bigger?
It resolves to one call:
{
"ability": "mailerpress/get-dashboard-contact-growth",
"parameters": {
"interval": 90
}
}Worth knowing
- Can go negative, and a negative month is the signal.
- The raw count rises even on a declining list.
- Rising hard bounces damage sender reputation site-wide.
- A confirming pending contact counts as growth.
Related abilities
- MailerPress Dashboard Contacts — the raw count
- MailerPress List Campaign Unsubscribed Contacts — which campaign caused a dip
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category