---
name: "notify_list_channels"
area: "notify"
title: "List notification channels"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/notify_list_channels"
mcp_server: "https://api.conecto.chat/mcp/notify"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/notify/notify_list_channels"
---

# List notification channels (`notify_list_channels`)

The saved channels: where each goes (never its token), the events it gets, and whether the last message arrived.

The saved channels, where each one goes (never its token), and whether the last message arrived.

Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing.

## Use it when

Before sending, to pick channel names, or when messages stop arriving.

## Say this to your agent

> Where can you send us alerts right now?

## Inputs

This tool takes no arguments: send `{}`.

## Example

Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon.

MCP: call `notify_list_channels` on the MCP server `https://api.conecto.chat/mcp/notify` with these arguments:

```json
{}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/notify_list_channels \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "notify_list_channels",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "channels": [
      {
        "name": "hiring",
        "kind": "slack",
        "target": "hooks.slack.com/...XXXX",
        "events": [
          "hiring.application_received",
          "hiring.test_completed"
        ],
        "last_sent_at": null,
        "last_error": null
      },
      {
        "name": "sale-2025",
        "kind": "slack",
        "target": "hooks.slack.com/...XXXX",
        "events": [],
        "last_sent_at": null,
        "last_error": null
      }
    ],
    "count": 3
  }
}
```

`result`: channels: each with its name, kind, target, events, last_sent_at and last_error; and count.

## Errors

This tool has no errors of its own.

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [notify_add_channel](https://conecto.chat/tools/notify/notify_add_channel.md): Saves a place to send messages by name: Slack, Teams, Discord or Google Chat, a Telegram chat, ntfy, Pushover, or the business's own webhook. $0.001 a call.
- [notify_send](https://conecto.chat/tools/notify/notify_send.md): Sends a message to one or more saved channels, with a title, a link or high priority; only the channels it reached are charged. $0.005 per channel reached.
- [notify_request_approval](https://conecto.chat/tools/notify/notify_request_approval.md): Asks a person to approve or decline (or pick an option) before the agent acts, on a one-time page sent through a channel or by email. $0.01 a request, $0.02 more by email, up to $0.03.
- [notify_get_approval](https://conecto.chat/tools/notify/notify_get_approval.md): Where a question asked with notify_request_approval stands, with the answer and comment once it has one. Free up to 1,000,000 reads a month.
- [notify_list_events](https://conecto.chat/tools/notify/notify_list_events.md): Every event a channel can get on its own: a job application, a booking, a form response, a signed document, a site going down and more. Free up to 1,000,000 reads a month.
- [notify_subscribe](https://conecto.chat/tools/notify/notify_subscribe.md): Sends chosen events to a saved channel as they happen, replacing the channel's list. $0.001 a call.
- [notify_unsubscribe](https://conecto.chat/tools/notify/notify_unsubscribe.md): Stops every event to a channel; the channel stays for notify_send. Free.
- [notify_remove_channel](https://conecto.chat/tools/notify/notify_remove_channel.md): Deletes a saved channel, with the events it got. Free.