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

# List events (`notify_list_events`)

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.

Every event a channel can receive on its own: a new job application, a booking, a form response, a signed document, a customer reply, a site going down and more.

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 choosing which events a channel gets.

## Say this to your agent

> What kinds of things can you alert us about automatically?

## 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_events` 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_events \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "notify_list_events",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "events": [
      {
        "event": "account.budget_alert",
        "when": "A team reached the alert line of its monthly budget (once a month)."
      },
      {
        "event": "account.balance_low",
        "when": "With auto-reload off, the balance is down to a fifth of what the last top-up left (once per top-up)."
      }
    ],
    "patterns": "Subscribe to one event, every event of an area (\"hiring.*\"), the events your bots send with account_emit_event (\"custom.*\" or one name, like \"custom.lead_qualified\"), or all (\"*\")."
  }
}
```

`result`: events: each event's name and when it happens; patterns: how to name all of an area's events.

## 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_list_channels](https://conecto.chat/tools/notify/notify_list_channels.md): The saved channels: where each goes (never its token), the events it gets, and whether the last message arrived. Free up to 1,000,000 reads a month.
- [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_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.