mailerpress/export-contacts kicks off an async export job and returns an export_id immediately.
MailerPress generates the archive via Action Scheduler and, if an address is given, emails a completion notification with the download link.
At a glance
| Ability | mailerpress/export-contacts |
| Toolset | MailerPress — toolset/mailerpress |
| Group | MailerPress › Contacts |
| Requires | AcrossAI Pro, plus MailerPress active on the site |
| Capability | manage_options |
| Safety | Read-only, but it produces a downloadable file of personal data and requires confirm: true. |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Pro 0.9.16 and later |
How it works
The empty-means-everything default is the thing to be deliberate about. Omitting contact_ids is not “export nothing” or “export a sample” — it is the whole list.
On a site with fifty thousand contacts that is a file containing fifty thousand people’s details, produced by a call with no parameters.
The email notification carries the download link, which means the link exists in an inbox and in whatever that inbox syncs to. That is convenient and it is a second place the data can be reached from.
Async means the file does not exist yet when the call returns. The export ID is how you find it later.
Exported personal data has a retention question attached to it. The archive sits wherever MailerPress puts it until somebody removes it.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
contact_ids | array | No | Which contacts to export. Empty exports every contact. |
email | string | No | Send a completion notification with the download link here. |
confirm | boolean | Yes — must be true | The irreversibility gate. Without it the call is refused before anything is touched. |
What comes back
| Name | Type | What it is |
|---|---|---|
export_id | string | The export job, for retrieving the file later. |
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:
Export our contact list.
It resolves to one call:
{
"ability": "mailerpress/export-contacts",
"parameters": {
"contact_ids": [118, 119],
"confirm": true
}
}Worth knowing
- An empty ID list exports everybody.
- The notification puts the download link in an inbox.
- The archive persists until somebody removes it.
- Async — the file is not ready when the call returns.
Related abilities
- MailerPress List Contacts — scope the export first
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category