Update 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 →

Update Action

Write
Ninja Forms Forms ninjaforms/update-action

Update an existing action's settings, or enable/disable it without deleting it.

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 updates a form action identified by form_id and action_id, changing only the fields supplied (label, active, to, subject, message, redirect_url, success_msg — passed as top-level parameters, not nested under a 'settings' object). Setting active to 0 disables the action without deleting it, which is the preferred way to handle 'turn off this action' requests; if the action being disabled is a save (Record Submission) action, the caller is expected to warn the user first that new submissions will stop being recorded and stored under Ninja Forms > Submissions, and wait for confirmation. Different action types use different content fields — email actions use message, while successmessage actions use success_msg — so an AI assistant needs to know the action's type (via ninjaforms/list-actions) before updating it.

See it in action

You ask your AI assistant

"Disable action 229 on form 12 instead of deleting it — we might turn it back on later."

Inputs

Name Type Required Description
form_id integer Yes The numeric ID of the form.
action_id integer Yes The numeric ID of the action to update.
label string No Action label.
active integer No 1 to enable, 0 to disable.
to string No Email recipient for email actions.
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 'action_id', 'form_id', an 'updated' count of changed settings, 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).

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.