Send an event of your own
Sends an event the agent names, custom.<name>, to the channels subscribed to it and to account_events.
$0.005 per channel it goes to
From your agent’s balance. A call that fails costs nothing.
An example
When you qualify a lead, tell Luis and our CRM sync without me picking channels each time.
Your agent callsaccount_emit_event$0.005 per channel it goes to
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.
{
"kind": "custom.lead_qualified",
"title": "The Alder Street Hotel is ready for a quote",
"data": {
"company": "The Alder Street Hotel",
"bikes": 8,
"deal_id": 4120
}
}Use it when
Something the agent did should reach Slack, a webhook or another team's agent, routed by the business's subscriptions instead of named channels.
- For a message to channels you name, use
notify_send.
What it does
Send an event you name, custom.<name> (custom.lead_qualified, custom.order_shipped), to every channel subscribed to it (notify_subscribe with "custom.*" or its name: Slack, Teams, a webhook to Zapier, Make, n8n or the business's own systems) and to account_events, where another team's bot can pick it up. data is any JSON object (up to 10 KB); sent_by is added with this bot's name and team. $0.005 for each channel it goes to; free when no channel is subscribed.
What comes back
The event as kept (event_id, kind, title, data with sent_by, time) and channels: how many it goes to. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
kindRequired | string | custom. and a name of lowercase letters, digits, dots, dashes and _. 8 to 66 characters, matches ^custom\.[a-z0-9][a-z0-9_.-]*$. |
titleRequired | string | 1 to 200 characters. |
text | string | Up to 4,000 characters. |
data | object | |
link | string | Up to 1,000 characters, matches ^https://. |
The call
Over MCP, call account_emit_event on https://api.conecto.chat/mcp/account. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/account_emit_event \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"kind":"custom.lead_qualified","title":"The Alder Street Hotel is ready for a quote","data":{"company":"The Alder Street Hotel","bikes":8,"deal_id":4120}}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
invalid_input400 | kind is not custom. and a name of lowercase letters, digits, dots, dashes and _. | Use a kind like custom.lead_qualified. |
too_large413 | data is over 10 KB of JSON. | Send less, and link to the record instead. |
unavailable503 | The event could not be saved. | Try again in a moment. |
More Account tools
All 28 tools- Check balance
account_balanceThe balance, this key's daily budget, auto-reload, and how much of the month's free reads and downloads is used.Free - Refund a top-up
account_refund_topupRefunds a top-up from the last 24 hours that none of has been used: the credit, with its tax, goes back to the card, and the service fee is kept.Free - Get a sign-in link for the owner
account_owner_linkA one-time link that signs the business owner into their Conecto page, without a password.Free - Read the limits
account_get_limitsThe limits Conecto raises on request, each with its standard and current value, and the business's requests with their answers.Free - Ask for a higher limit
account_request_limitAsk Conecto to raise a limit: which one, the number the business needs, and why.Free - Read recent events
account_eventsWhat happened lately, oldest first: applications, bookings, form responses, signatures, replies, emails, website goals and the agents' own events.Free* - Search everything
account_searchOne search across the business's files, table rows, help articles, CRM, emails, tickets, invoices, books, stock and tasks.Free* - List calls
account_list_callsThe business's recent calls, newest first, optionally only the failed or the succeeded ones, or one area's.Free
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md