Add Submission Note 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 →

Add Submission Note

Write
Fluent Forms Forms fluentform/add-submission-note

Attach an internal staff note to one entry; not visible to the submitter.

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

Adds an internal note to a single entry, visible only to staff in the admin Entries screen, never to the person who submitted the form. The note text is plain text (HTML tags are stripped on save) and is bound into the confirm_token, so the note previewed to the operator is the only note that token can go on to write. Requires dry_run:true first to preview the note and obtain a confirm_token, then a repeat call with the same entry_id and content plus confirm_token to execute.

See it in action

You ask your AI assistant

"Add a note to entry 245 saying "Called customer, will follow up Friday.""

Inputs

Name Type Required Description
entry_id integer Yes The submission id to annotate.
content string Yes Note text (plain text; HTML tags are stripped).
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: the entry_id, form_id, a note preview, a visibility note, and a confirm_token. On execute: the entry id and the new note's id.

Permission

Requires the fluentform_manage_entries 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.