Add Action is a WordPress ability from Ninja Forms — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →Add Action
WriteAdd a post-submission action to a form — email, redirect, success message, or save.
Requires the Ninja Forms plugin on WordPress 6.9+ for the Abilities API (all 32 abilities are registered only when the wp_register_ability() function exists, via NF_Abilities_Integration::load_abilities_api() running on plugins_loaded). Every ability is gated by the same ninja_forms_ability_can_manage_forms() permission callback, requiring the caller to hold WordPress's manage_options capability or Ninja Forms' own nf_edit_forms capability.
What it does
This ability attaches a new action to a form that fires after submission: email (with to/subject/message), redirect (with redirect_url), successmessage (with success_msg — note this is a different field name than email's message), or save, among others. A save action needs no extra parameters beyond type and label; Ninja Forms handles its parent_id wiring automatically so submissions are recorded to the database. This lets an AI assistant wire up notification emails, custom thank-you messages, or redirects directly, resolving field keys for merge tags via ninjaforms/get-form when it needs to reference a submitted value like {field:email_1234567890123}.
See it in action
You ask your AI assistant
"Add an email action to form 12 that sends a confirmation to the address entered in the Email field, with subject 'Thanks for signing up!'."
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| form_id | integer | Yes | The numeric ID of the form to add the action to. |
| type | string | Yes | Action type, e.g. email, redirect, successmessage, save. |
| label | string | No | Action label. |
| active | integer | No | Whether the action is active (1) or inactive (0). |
| to | string | No | Email recipient for email actions; supports merge tags like {wp:admin_email} or {field:key}. |
| subject | string | No | Email subject for email actions. |
| message | string | No | Email body for email actions. |
| redirect_url | string | No | Target URL for redirect actions. |
| success_msg | string | No | Success message text for successmessage actions. |
Returns
An object with a 'success' boolean, the 'form_id', the new 'action_id', the action 'type', and a 'message'.
Permission
The current user must have WordPress's 'manage_options' capability or Ninja Forms' own 'nf_edit_forms' capability (checked via the shared ninja_forms_ability_can_manage_forms() permission callback).
More Ninja Forms abilities
Add Calculation
Add a calculator formula to a form for use in calc fields and conditional logic.
Add Field
Add a single field to an existing form, to be called once per field when building out a form.
Create Form
Create a new Ninja Forms form, optionally with fields, actions, and calculations, in a single call.
Delete Action
Permanently delete an action from a form.
Delete Calculation
Permanently delete a calculation from a form.
Delete Form
Permanently delete a form and all of its fields, actions, and submissions.