conecto. Get started
Notifications

List events

notify_list_events · Reads only · Markdown

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*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

What kinds of things can you alert us about automatically?

Your agent callsnotify_list_eventsFree*

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments
{}
What comes back
{
  "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 (\"*\")."
}

Use it when

Before choosing which events a channel gets.

What it does

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.

What comes back

events: each event's name and when it happens; patterns: how to name all of an area's events. Every reply also carries cost_usd and balance_usd.

The call

Over MCP, call notify_list_events on https://api.conecto.chat/mcp/notify. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/notify_list_events \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

More Notifications tools

All 9 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md