Read recent events
What happened lately, oldest first: applications, bookings, form responses, signatures, replies, emails, website goals and the agents' own events.
Free*
*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.
An example
Anything new since last night? Bookings, form replies, signed contracts?
Your agent callsaccount_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.
{
"after": 1520,
"kinds": [
"calendar.*",
"forms.*",
"esign.*"
]
}Use it when
To catch up on what happened since the last check: pass after, the last event_id you saw.
- For events delivered to Slack, Teams or a webhook as they happen, use
notify_subscribe.
What it does
What happened in this account that someone outside the bot did, oldest first: applications, bookings, form responses, signatures, replies, emails received, goals reached on the website; and the custom events bots sent with account_emit_event. Kept 30 days. Poll with after = the last event_id you saw.
What comes back
Events oldest first, each with its event_id, kind, title, text, data, link and time, and next_after for the next poll. Without after, only the last 24 hours. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
after | integer | Only events after this event_id. At least 0. |
kinds | array of strings | Event names or areas ("hiring.*"); all when left out. Up to 30 items. |
limit | integer | 1 to 200. Default: 50. |
The call
Over MCP, call account_events on https://api.conecto.chat/mcp/account. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/account_events \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"after":1520,"kinds":["calendar.*","forms.*","esign.*"]}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
invalid_input400 | A name in kinds is no event and no area pattern. | Use event names from notify_list_events, an area like "calendar.*", or "*" for all. |
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 - Send an event of your own
account_emit_eventSends an event the agent names, custom.<name>, to the channels subscribed to it and to account_events.$0.005 per channel it goes to - 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