---
title: "list_notification_channels — AI Ability"
description: "List notification channels — The destinations rules can send to, by id, name and type. Channels hold secrets and are created only in the admin UI."
url: "https://wpwebhooks.org/docs/ability-list-notification-channels/"
---

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

AI Ability since v3.3.0

# list\_notification\_channels

List notification channels — The destinations rules can send to, by id, name and type. Channels hold secrets and are created only in the admin UI.

Lists the notification channels configured on the site (email, Slack, Discord, Telegram, Teams, SMS, PagerDuty, …) by id, name, type, enabled state and last error. Rules reference channels by id. Channels hold secrets, so they are created only in the admin UI (Notifications → Channels) — the ability returns metadata only, never a webhook URL or token. Registered as the WordPress Ability `flowsystems-webhook-actions/list-notification-channels`, 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_channels", "input": {} }
```

/ Scope & confirmation

Minimum API-token scope for external (MCP/REST) callers: `read`. Build with AI calls it before proposing a rule so the plan names a real channel id; if no channel fits, the agent tells you to add one rather than inventing an id.

/ Examples

Plan step as Build with AI proposes it

```
{
  "id": "step_1",
  "ability": "list_notification_channels",
  "summary": "Find the Slack channel to alert",
  "input": {}
}
```

/ 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":"list_notification_channels — AI Ability — Webhook Actions Docs","description":"List notification channels — The destinations rules can send to, by id, name and type. Channels hold secrets and are created only in the admin UI.","url":"https://wpwebhooks.org/docs/ability-list-notification-channels/","isPartOf":{"@type":"WebSite","name":"WP Webhooks","url":"https://wpwebhooks.org"},"about":{"@type":"SoftwareApplication","name":"Webhook Actions","applicationCategory":"WordPress Plugin"}}
```