---
name: "notify_send"
area: "notify"
title: "Send a notification"
price: "$0.005 per channel reached"
method: "POST"
url: "https://api.conecto.chat/v1/tools/notify_send"
mcp_server: "https://api.conecto.chat/mcp/notify"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/notify/notify_send"
---

# Send a notification (`notify_send`)

Sends a message to one or more saved channels, with a title, a link or high priority; only the channels it reached are charged.

Send a message to one or more saved channels. Charged only for the channels it reached.

Price: $0.005 per channel reached. A call that fails costs nothing.

## Use it when

The team should know something now: a big order, a complaint, a delivery problem.

- For an email to a customer or a supplier, use [email_send](https://conecto.chat/tools/email/email_send.md).
- For the same message on a timetable, use [schedules_create](https://conecto.chat/tools/schedules/schedules_create.md).
- For events sent as they happen, use [notify_subscribe](https://conecto.chat/tools/notify/notify_subscribe.md).

## Say this to your agent

> Tell the workshop in Slack that the Alder Street Hotel just ordered 8 guest bikes for December 1.

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `channels` | array of strings | yes | 1 to 10 items. |  |  |
| `message` | string | yes | 1 to 4,000 characters. |  |  |
| `title` | string | no | Up to 200 characters. |  |  |
| `link` | string | no | An https link to open, e.g. the deal or ticket. Up to 1,000 characters, matches ^https://. |  |  |
| `urgent` | boolean | no | High priority where the channel has one (ntfy, Pushover). |  | `false` |

## Example

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

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

```json
{
  "channels": [
    "workshop"
  ],
  "title": "New order: the Alder Street Hotel",
  "message": "8 Willamette 8 city bikes, built and delivered by December 1. The deal is in the CRM."
}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/notify_send \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channels": ["workshop"], "title": "New order: the Alder Street Hotel", "message": "8 Willamette 8 city bikes, built and delivered by December 1. The deal is in the CRM."}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "notify_send",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.005",
  "balance_usd": "$19.75",
  "result": {
    "results": [
      {
        "channel": "workshop",
        "sent": true
      }
    ],
    "reached": 1
  }
}
```

`result`: results: each channel with sent (true or false) and the error if it failed; reached: how many got it.

## Errors

| Code | Status | When | Fix |
|---|---|---|---|
| `not_found` | 404 | A channel name is not saved. | Call notify_list_channels for the names. |
| `delivery_failed` | 502 | The message reached no channel; nothing was charged. | Read each channel's error in the message; add a broken one again. |

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_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.