Send a notification
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
From your agent’s balance. A call that fails costs nothing.
An example
Tell the workshop in Slack that the Alder Street Hotel just ordered 8 guest bikes for December 1.
Your agent callsnotify_send$0.005 per channel reached
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.
{
"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."
}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. - For the same message on a timetable, use
schedules_create. - For events sent as they happen, use
notify_subscribe.
What it does
Send a message to one or more saved channels. Charged only for the channels it reached.
What comes back
results: each channel with sent (true or false) and the error if it failed; reached: how many got it. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
channelsRequired | array of strings | 1 to 10 items. |
messageRequired | string | 1 to 4,000 characters. |
title | string | Up to 200 characters. |
link | string | An https link to open, e.g. the deal or ticket. Up to 1,000 characters, matches ^https://. |
urgent | boolean | High priority where the channel has one (ntfy, Pushover). Default: false. |
The call
Over MCP, call notify_send on https://api.conecto.chat/mcp/notify. Over REST:
curl -X POST 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."}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | A channel name is not saved. | Call notify_list_channels for the names. |
delivery_failed502 | The message reached no channel; nothing was charged. | Read each channel's error in the message; add a broken one again. |
More Notifications tools
All 9 tools- Add a notification channel
notify_add_channelSaves 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 - List notification channels
notify_list_channelsThe saved channels: where each goes (never its token), the events it gets, and whether the last message arrived.Free* - Ask a person to approve
notify_request_approvalAsks 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 - Check an approval
notify_get_approvalWhere a question asked with notify_request_approval stands, with the answer and comment once it has one.Free* - List events
notify_list_eventsEvery 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* - Send events to a channel
notify_subscribeSends chosen events to a saved channel as they happen, replacing the channel's list.$0.001 a call - Stop events to a channel
notify_unsubscribeStops every event to a channel; the channel stays for notify_send.Free - Remove a notification channel
notify_remove_channelDeletes a saved channel, with the events it got.Free
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md