mailerpress/list-campaign-clicked-contacts returns a paginated list of contacts who clicked at least one tracked link in a given batch.
Rows carry the first and last click times and a click count.
At a glance
| Ability | mailerpress/list-campaign-clicked-contacts |
| 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
Clicks are the reliable engagement signal. Unlike an open, a click is a real navigation by a real person — there is no image-blocking equivalent that suppresses it and no pre-fetching equivalent that fabricates it.
So a click list is a roll call in a way an open list is not, and it is the right basis for follow-up.
The click count and the time span between first and last are more informative than the binary. Somebody who clicked once is interested; somebody who clicked six times over three days is very interested, and those are different follow-ups.
Only tracked links count. A campaign whose links were not rewritten for tracking records nothing here, however much clicking happened.
Per batch, like the other contact-level reads.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
batch_id | integer | Yes | The send batch. |
search | string | No | Wildcard search on email or name. |
per_page | integer | No | Rows per page. |
What comes back
| Name | Type | What it is |
|---|---|---|
contacts | array | Each contact with first and last click times and a click count. |
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:
Who clicked through from that campaign?
It resolves to one call:
{
"ability": "mailerpress/list-campaign-clicked-contacts",
"parameters": {
"batch_id": 91
}
}Worth knowing
- Clicks are reliable where opens are not.
- The count and time span distinguish mild from strong interest.
- Untracked links record nothing.
- Read-only.
Related abilities
- MailerPress List Campaign Opened Contacts — the softer signal
- MailerPress Get Contact Stats — one contact’s totals
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category