30 days free. No credit card. Full access from the moment you connect your site.

Start free trial

MailerPress Get Campaign Email Logs

mailerpress/get-campaign-email-logs returns a paginated per-email log for a campaign from MailerPress’s email logger.

Rows carry the recipient, subject, the SMTP service that handled it, the status and any error message.

At a glance

Abilitymailerpress/get-campaign-email-logs
ToolsetMailerPress — toolset/mailerpress
GroupMailerPress › Campaigns & Sending
RequiresAcrossAI Pro, plus MailerPress active on the site
Capabilitymanage_options
SafetyRead-only — changes nothing
RepeatableIdempotent — running it twice leaves the same result
Ships inAcrossAI Pro 0.9.16 and later

How it works

This is the provider-level view, as against the engagement view in mailerpress/get-campaign-logs. It answers whether the email left the site and what the provider said about it.

Filtering to error is the useful mode. A campaign with a hundred failures usually has one cause — an authentication problem, a rate limit, a rejected sending domain — and the error messages say which.

The service column matters on sites with more than one provider configured. Failures concentrated on one driver point at that driver rather than at the campaign.

pending rows are emails the logger has recorded and the provider has not yet confirmed, which on a large send is normal mid-flight and suspicious afterwards.

These rows accumulate indefinitely — MailerPress provides no retention policy — which is what mailerpress/prune-email-logs exists for.

Input

NameTypeRequiredWhat it is
idintegerYesThe campaign ID.
statusstringNosuccess, error or pending.
per_pageintegerNoRows per page.

What comes back

NameTypeWhat it is
logsarrayPer email: recipient, subject, service, status, error message and timestamps.
successbooleanWhether the call completed.
messagestringA one-line summary of what happened, suitable for showing a human.
error_codestringPresent 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:

Why did some of those emails fail?

It resolves to one call:

{
  "ability": "mailerpress/get-campaign-email-logs",
  "parameters": {
    "id": 44,
    "status": "error"
  }
}

Worth knowing

  • Provider-level, not engagement. This is whether the email left the site.
  • A hundred failures usually share one cause, named in the error messages.
  • Failures concentrated on one service point at that service.
  • These rows accumulate forever unless pruned.

Related abilities


Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager

Browse the rest: Every ability, by category


Keep reading