---
title: "list_notification_rules — AI Ability"
description: "List notification rules — Site-wide rules, or one webhook's own rules. Each rule = event + filters + channel_ids + optional template."
url: "https://wpwebhooks.org/docs/ability-list-notification-rules/"
---

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

AI Ability since v3.3.0

# list\_notification\_rules

List notification rules — Site-wide rules, or one webhook's own rules. Each rule = event + filters + channel\_ids + optional template.

Lists notification rules: the site-wide ones (`webhook_id` null) or a webhook's own when `webhook_id` is passed. Each rule carries its event, filters, channel ids, template, quiet time and digest setting. Registered as the WordPress Ability `flowsystems-webhook-actions/list-notification-rules`, 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": "list_notification_rules", "input": { "webhook_id": … } }
```

/ Scope & confirmation

Minimum API-token scope for external (MCP/REST) callers: `read`.

/ Input fields

| Name | In | Type | Req | Description |
| --- | --- | --- | --- | --- |
| webhook\_id | param | integer | — | Omit for site-wide rules. |

/ Examples

Plan step as Build with AI proposes it

```
{
  "id": "step_1",
  "ability": "list_notification_rules",
  "summary": "Check what already alerts for this webhook",
  "input": {
    "webhook_id": 12
  }
}
```

/ Related

[create\_notification\_rule](https://wpwebhooks.org/docs/ability-create-notification-rule/)[update\_notification\_rule](https://wpwebhooks.org/docs/ability-update-notification-rule/)[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":"list_notification_rules — AI Ability — Webhook Actions Docs","description":"List notification rules — Site-wide rules, or one webhook's own rules. Each rule = event + filters + channel_ids + optional template.","url":"https://wpwebhooks.org/docs/ability-list-notification-rules/","isPartOf":{"@type":"WebSite","name":"WP Webhooks","url":"https://wpwebhooks.org"},"about":{"@type":"SoftwareApplication","name":"Webhook Actions","applicationCategory":"WordPress Plugin"}}
```