---
title: "update_notification_rule — AI Ability"
description: "Update a notification rule — Change its event, channels, filters, template, throttle, digest or enabled state."
url: "https://wpwebhooks.org/docs/ability-update-notification-rule/"
---

[WP Webhooks](https://wpwebhooks.org/) / [Docs](https://wpwebhooks.org/docs/) / update\_notification\_rule

AI Ability since v3.3.0

# update\_notification\_rule

Update a notification rule — Change its event, channels, filters, template, throttle, digest or enabled state.

Changes an existing notification rule. Same fields as `create_notification_rule` plus `id`; only the fields passed are changed, and a new template goes through the same linter. Registered as the WordPress Ability `flowsystems-webhook-actions/update-notification-rule`, so external AI tools (Claude Code, Cursor) can call it over MCP, or over the Abilities REST route with a scoped API token.

/ Plan step shape

```
{ "ability": "update_notification_rule", "input": { "id": …, "is_enabled": …, "template": {…} } }
```

/ Scope & confirmation

Minimum API-token scope for external (MCP/REST) callers: `full`. Runs without a confirmation pause (the overall plan is still user-approved before execution starts).

/ Input fields

| Name | In | Type | Req | Description |
| --- | --- | --- | --- | --- |
| id | param | integer | yes |  |
| event | param | string | — |  |
| channel\_ids | param | integer\[\] | — |  |
| filters | param | object | — |  |
| template | param | object | — |  |
| throttle\_seconds | param | integer | — |  |
| digest | param | string | — | \`hourly\` | \`daily\`. |
| is\_enabled | param | boolean | — |  |

/ Examples

Plan step as Build with AI proposes it

```
{
  "id": "step_2",
  "ability": "update_notification_rule",
  "summary": "Quiet the success rule to one message an hour",
  "input": {
    "id": 7,
    "throttle_seconds": 3600
  }
}
```

/ Related

[create\_notification\_rule](https://wpwebhooks.org/docs/ability-create-notification-rule/)[list\_notification\_rules](https://wpwebhooks.org/docs/ability-list-notification-rules/)[Notifications](https://wpwebhooks.org/docs/notifications/)[REST API reference](https://wpwebhooks.org/webhook-wordpress-plugin-api/)

/Ready

## Your next automation is  
one sentence away.

[Install Plugin→](https://downloads.wordpress.org/plugin/flowsystems-webhook-actions.zip) [Try the Live Preview](https://playground.wordpress.net/?blueprint-url=https://wpwebhooks.org/blueprint.json) [See the Plugin →](https://wpwebhooks.org/wordpress-webhook-plugin/)

$ wp plugin install flowsystems-webhook-actions --activate

## Structured data

```json
{"@context":"https://schema.org","@type":"TechArticle","name":"update_notification_rule — AI Ability — Webhook Actions Docs","description":"Update a notification rule — Change its event, channels, filters, template, throttle, digest or enabled state.","url":"https://wpwebhooks.org/docs/ability-update-notification-rule/","isPartOf":{"@type":"WebSite","name":"WP Webhooks","url":"https://wpwebhooks.org"},"about":{"@type":"SoftwareApplication","name":"Webhook Actions","applicationCategory":"WordPress Plugin"}}
```