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

Start free trial

MailerPress Pro Send Test WordPress Email

mailerpress-pro/send-test-wordpress-email sends a test rendering of the currently configured template for a WordPress email type.

It has an external side effect: an email is actually delivered.

At a glance

Abilitymailerpress-pro/send-test-wordpress-email
ToolsetMailerPress Pro — toolset/mailerpress-pro
GroupMailerPress Pro › WordPress Emails
RequiresAcrossAI Pro, plus MailerPress with its Pro add-on active on the site
Capabilitymanage_options
SafetyWrites data
RepeatableNot idempotent — each call changes the row set, so re-running is not a no-op
Ships inAcrossAI Pro 0.9.16 and later

This sends a real email

This actually sends an email to the address given. It is not a preview and not a dry run — the message leaves the site through the configured mail path and lands in a real inbox. Use an address you control, and remember that a test of a password-reset template contains whatever the template renders for a placeholder — which is not a working reset link, and should not be treated as one.

How it works

Testing a transactional template any other way does not work. The rendering involves the campaign, the personalisation tokens for that email type, and the site’s mail path — and the last of those is where transactional email most often fails.

A template that renders perfectly and never arrives is a mail delivery problem, and only an actual send surfaces it.

So this is the verification step after mailerpress-pro/save-wordpress-email-template, and it is worth doing every time rather than when something seems wrong.

The tokens render against placeholder data rather than a real event, so links in the test are not functional links. What the test proves is that the template renders and the mail arrives, not that a real reset would work end to end.

Not idempotent — each call sends another email.

Input

NameTypeRequiredWhat it is
typestringYesThe WordPress email type to test.
tostringYesThe address to send to. Use one you control.

What comes back

NameTypeWhat it is
sentbooleanWhether the send was accepted by the mail path.
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:

Send me a test of the password reset email.

It resolves to one call:

{
  "ability": "mailerpress-pro/send-test-wordpress-email",
  "parameters": {
    "type": "password-reset",
    "to": "me@example.com"
  }
}

Worth knowing

  • A real email is delivered. Use an address you control.
  • Links in the test render against placeholders and are not functional.
  • This is the only way to catch a mail-path failure.
  • Not idempotent — each call sends.

Related abilities


Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager

Browse the rest: Every ability, by category


Keep reading