The autoresponder is the one Contact Form 7 feature that mails your visitors rather than you. Turning it on is therefore a different kind of decision from editing it, and this ability is deliberately separate from contact-form-7/update-mail.
Switch it on while mail_2 is still empty and every person who submits the form gets a blank email from your domain.
At a glance
| Ability | contact-form-7/toggle-mail-2 |
| Toolset | Contact Form 7 — toolset/contact-form-7 |
| Group | Contact Form 7 › Mail & Notifications |
| Requires | Contact Form 7, active on the site |
| Capability | manage_options, plus edit_contact_forms |
| Safety | Writes data |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Abilities Manager 0.0.34 and later |
Before you switch it on
Read mail_2 with contact-form-7/get-mail before enabling it. The response here lists any tags in the autoresponder that match no field on the form — which, on a template that was written for a different form, is how a visitor receives a reply with blanks in it.
How it works
Activation is a flag on the mail template, not a separate object. The content is already there whether the autoresponder is on or off — which is why an empty one can be switched on and immediately start sending nothing.
When you enable it, the response returns unresolved_tags: every mail tag in the autoresponder that matches no field on this form, as { field, tag } pairs.
The operation is idempotent. Enabling an already-enabled autoresponder reports the same result and sends nothing.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
form_id | integer | Yes | Form post ID, as returned by contact-form-7/list-forms. |
active | boolean | Yes | Whether the autoresponder should be on. |
What comes back
| Name | Type | What it is |
|---|---|---|
form_id | integer | The form that was written. |
active | boolean | The state after the call. |
mail_2 | object | The autoresponder template. |
unresolved_tags | array | Tags in the autoresponder matching no field, reported when it is enabled. |
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:
Turn on the autoresponder for form 42.
It resolves to one call:
{
"ability": "contact-form-7/toggle-mail-2",
"parameters": {
"form_id": 42,
"active": true
}
}Worth knowing
- Write the content before you flip the switch. An empty autoresponder sends empty mail.
- The autoresponder needs a recipient tag such as
[your-email]in its recipient field, or it has nowhere to go. - Idempotent — the state you ask for is the state you get, however many times you ask.
Related abilities
- Get Contact Form Mail Template — read mail_2 before enabling
- Update Contact Form Mail Template — write the autoresponder content
- Validate Contact Form Mail Tags — check both templates
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category