mailerpress-pro/save-webhook creates or updates an incoming webhook, addressed by webhook_id.
If the secret is omitted, MailerPress generates a random one on first save — and that is the only moment it exists in readable form.
At a glance
| Ability | mailerpress-pro/save-webhook |
| Toolset | MailerPress Pro — toolset/mailerpress-pro |
| Group | MailerPress Pro › Webhooks |
| Requires | AcrossAI Pro, plus MailerPress with its Pro add-on active on the site |
| Capability | manage_options |
| Safety | Writes data |
| Repeatable | Not idempotent — each call changes the row set, so re-running is not a no-op |
| Ships in | AcrossAI Pro 0.9.16 and later |
One call, two operations
Save is create-or-update: an unknown ID creates, a known one updates. That is convenient and it means a typo in the ID silently creates a second webhook rather than updating the one you meant.
So read the list first when updating. The ID is alphanumeric with hyphens and underscores only, which rules out the shapes most likely to be mistyped but not all of them.
The secret is how the receiving end verifies the caller. Letting MailerPress generate it is the better default — a generated secret is stronger than a chosen one — but it is returned once and stored one-way, so it has to be captured at that moment and given to whatever will be calling.
Losing it means saving a new one, which invalidates the old and breaks the integration until the new secret is deployed at the other end.
Not idempotent when creating.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
webhook_id | string | Yes | Alphanumerics, hyphens and underscores only. Unknown IDs create; known ones update. |
secret | string | No | Omit to have one generated. Returned once and never readable again. |
config | object | No | The webhook configuration. |
What comes back
| Name | Type | What it is |
|---|---|---|
webhook | object | The webhook, with the secret only on first creation. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
Set up a webhook for our signup form.
It resolves to one call:
{
"ability": "mailerpress-pro/save-webhook",
"parameters": {
"webhook_id": "signup-form"
}
}Worth knowing
- An unknown ID creates rather than erroring. Read the list before updating.
- A generated secret is returned once and never again.
- Losing the secret means rotating it and redeploying the caller.
- Not idempotent when creating.
Related abilities
- MailerPress Pro List Webhooks — check the ID before updating
- MailerPress Pro Delete Webhook — remove one
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category