Create or Update Email Notification is a WordPress ability from Fluent Forms — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.

Install Free Plugin →

Create or Update Email Notification

Destructive
Fluent Forms Forms fluentform/upsert-email-notification

Create a new email notification or update an existing one — including its recipient.

Needs the Fluent Forms MCP server switched on in FluentForm → Settings → MCP, and WordPress 6.9+ so wp_register_ability() exists (abilities are only registered when the function is present). Reaching the server also requires a logged-in WordPress user holding at least one FluentForm capability. Each ability additionally checks a specific FluentForm capability (e.g. fluentform_dashboard_access, fluentform_forms_manager, fluentform_entries_viewer, fluentform_manage_entries, fluentform_view_payments, fluentform_settings_manager) via the plugin's own Acl system, and every write ability requires a two-step dry_run → confirm_token round-trip through WriteGuard before anything is persisted. Note (from source comments): a WordPress role granted FluentForm access via the Role Manager passes every per-ability capability check, including delete-submission and bulk delete_permanently — the real boundary for such a user is 'has FluentForm access, restricted to their form scope', not per-tool separation; only individually-assigned 'specific forms' managers are gated the way each ability's declared capability implies.

What it does

Creates a new email notification when notification_id is omitted, or updates an existing one (verified to belong to the given form_id, so a foreign id can never fork a new notification onto the wrong form) when it is supplied. On update, only the fields passed are changed; everything else is preserved via a read-modify-merge-write inside a row-locked transaction. subject and message are required to create, and message is HTML that is sanitized on save through the same path the admin Email Notifications screen uses (SettingsService::store). The recipient is set via send_to_type: "email" with send_to_email (a fixed address or a {smartcode}), or "field" with send_to_field (a form field key). It is annotated destructive rather than merely a write because repointing sendTo silently redirects every future submission of the form to a new mailbox with no signal anywhere in the admin UI — the dry-run preview spells out the old and new recipient explicitly so an operator can catch a redirect before it happens, and the confirm_token binds the resulting notification content so it can't be replayed to smuggle a different recipient onto the same edit.

See it in action

You ask your AI assistant

"Update the email notification on form 12 to send to support@example.com instead of the current address."

Inputs

Name Type Required Description
form_id integer Yes Required. The form the notification belongs to.
notification_id integer No Omit to create; pass an id from list-email-notifications to update.
name string No Admin label for the notification.
subject string No Email subject (required to create).
message string No Email body, HTML allowed (required to create). Sanitized on save.
send_to_type string No How to resolve the recipient: email or field. Default email.
send_to_email string No Recipient when send_to_type=email; a fixed address or a {smartcode}.
send_to_field string No Recipient field key when send_to_type=field.
from_name string No Sender name.
from_email string No Sender email address.
reply_to string No Reply-to address.
enabled boolean No Whether this notification fires. Default true on create.
dry_run boolean No Preview the change without writing; returns a confirm_token.
confirm_token string No The token from the dry_run preview, required to execute.
idempotency_key string No Optional; a retry with the same key will not act twice.

Returns

On dry_run: form_id, notification_id (null on create), the action (create/update), a recipient from/to comparison, a subject from/to comparison, the enabled flag, a redirect warning, and a confirm_token. On execute: form_id, the notification_id (new or existing), and the enabled flag.

Permission

Requires the fluentform_forms_manager capability.

Newsletter

The AI + WordPress space moves fast. Keep up.

New tools, workflow ideas, and product updates — be the first to know what's next.

No spam, unsubscribe anytime.