Update connection metadata is a WordPress ability from SureMail — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →Update connection metadata
WriteUpdates the non-credential metadata of an existing connection, such as its sender name or title.
Requires the SureMail plugin installed on WordPress 6.9+ (for Abilities API support). Every ability also requires the current user to have the 'manage_options' capability. Abilities that create, modify, resend, or delete data are additionally gated behind separate site options: the destructive abilities (delete-connection, delete-email-logs) require the 'suremails_abilities_api_delete' option to be enabled, and the write abilities (add-connection, update-connection, send-test-email, resend-email, update-settings) require the 'suremails_abilities_api_edit' option to be enabled.
What it does
This ability changes an existing connection's from_email, from_name, connection_title, force_from_email, or force_from_name — only the fields supplied are updated, and all others are left untouched. Credentials like API keys and passwords cannot be changed here; the connection must be deleted and re-created for that. If the target connection is the site's current default, the stored default-connection summary is refreshed automatically.
See it in action
You ask your AI assistant
"Update connection conn_123 so its display name is 'Marketing Team' and it always forces the from-name."
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | The connection ID to update. Obtain this from list-connections. |
| from_email | string | No | New sender email address. |
| from_name | string | No | New sender display name. |
| connection_title | string | No | New connection title shown in the dashboard. |
| force_from_email | boolean | No | When true, all outgoing emails use this connection's from_email, overriding any from address set by other plugins or themes. |
| force_from_name | boolean | No | When true, all outgoing emails use this connection's from_name, overriding any sender name set by other plugins or themes. |
Returns
An object with success (boolean), a result message, and the updated connection's id, type, from_email, from_name, connection_title, force_from_email, and force_from_name.
Permission
Requires the 'suremails_abilities_api_edit' site option to be enabled, and the current user must have the 'manage_options' capability.
More SureMail abilities
Add new email connection
Creates and authenticates a new email-sending connection against its provider's credentials.
Delete connection
Permanently deletes an email connection by ID, an action that cannot be undone.
Delete email logs
Permanently deletes one or more email log entries and any attachments used only by them.
Get connection details
Retrieves the full non-sensitive details of a single email connection by its ID.
Get default connection
Returns the connection that WordPress is currently using to send all outgoing emails.
Get email delivery statistics
Returns aggregate sent/failed email counts and a daily breakdown for a given date range.