---
name: "account_events"
area: "account"
title: "Read recent events"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/account_events"
mcp_server: "https://api.conecto.chat/mcp/account"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/account/account_events"
---

# Read recent events (`account_events`)

What happened lately, oldest first: applications, bookings, form responses, signatures, replies, emails, website goals and the agents' own events.

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.

Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing.

## 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](https://conecto.chat/tools/notify/notify_subscribe.md).

## Say this to your agent

> Anything new since last night? Bookings, form replies, signed contracts?

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `after` | integer | no | Only events after this event_id. At least 0. |  |  |
| `kinds` | array of strings | no | Event names or areas ("hiring.*"); all when left out. Up to 30 items. |  |  |
| `limit` | integer | no | 1 to 200. |  | `50` |

## Example

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

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

```json
{
  "after": 1520,
  "kinds": [
    "calendar.*",
    "forms.*",
    "esign.*"
  ]
}
```

REST:

```bash
curl 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.*"]}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "account_events",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "events": [
      {
        "event_id": 4101,
        "kind": "calendar.booking_created",
        "title": "Rachel Kim booked Bike fitting",
        "text": "Saturday, October 24, 2026 at 11:30 (America/Los Angeles)",
        "data": {
          "reference": "CUT49YHZ85",
          "meeting_type": "bike-fitting",
          "start": "2026-10-24T11:30:00-07:00",
          "end": "2026-10-24T19:15:00+00:00",
          "name": "Rachel Kim",
          "email": "rachel.kim@example.com",
          "phone": null,
          "source": "bot",
          "reason": null
        },
        "link": null,
        "occurred_at": "2026-10-14T08:00:00+00:00"
      }
    ],
    "next_after": 4101,
    "note": null
  }
}
```

`result`: 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.

## Errors

| Code | Status | When | Fix |
|---|---|---|---|
| `invalid_input` | 400 | 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. |

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [account_balance](https://conecto.chat/tools/account/account_balance.md): The balance, this key's daily budget, auto-reload, and how much of the month's free reads and downloads is used. Free.
- [account_refund_topup](https://conecto.chat/tools/account/account_refund_topup.md): Refunds 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.
- [account_owner_link](https://conecto.chat/tools/account/account_owner_link.md): A one-time link that signs the business owner into their Conecto page, without a password. Free.
- [account_get_limits](https://conecto.chat/tools/account/account_get_limits.md): The limits Conecto raises on request, each with its standard and current value, and the business's requests with their answers. Free.
- [account_request_limit](https://conecto.chat/tools/account/account_request_limit.md): Ask Conecto to raise a limit: which one, the number the business needs, and why. Free.
- [account_emit_event](https://conecto.chat/tools/account/account_emit_event.md): 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.
- [account_search](https://conecto.chat/tools/account/account_search.md): One search across the business's files, table rows, help articles, CRM, emails, tickets, invoices, books, stock and tasks. Free up to 1,000,000 reads a month.
- [account_list_calls](https://conecto.chat/tools/account/account_list_calls.md): The business's recent calls, newest first, optionally only the failed or the succeeded ones, or one area's. Free.
- [account_dashboard_link](https://conecto.chat/tools/account/account_dashboard_link.md): A one-time link to a page showing one area at a glance, made when it opens from what this key may read. Free up to 1,000,000 reads a month.
- [account_get_call](https://conecto.chat/tools/account/account_get_call.md): One call by its call_id, with its status, cost and result. Free.
- [account_get_brand](https://conecto.chat/tools/account/account_get_brand.md): The name, logo, colour and footer line the business's emails and published pages carry. Free up to 1,000,000 reads a month.
- [account_set_brand](https://conecto.chat/tools/account/account_set_brand.md): Sets the sender name, logo, colour and footer on every email to customers and on the business's published pages. $0.001 a call.
- [account_list_email_templates](https://conecto.chat/tools/account/account_list_email_templates.md): Every automatic email to the business's customers, with its subject, headline, opening words and {variables}. Free up to 1,000,000 reads a month.
- [account_set_email_template](https://conecto.chat/tools/account/account_set_email_template.md): Rewrites an email's subject, headline or opening words in the business's voice; the times, amounts and links below them stay. $0.001 a call.
- [account_export_all](https://conecto.chat/tools/account/account_export_all.md): Everything the account holds, as ZIP files in its file store: every record as JSON Lines and the stored files, credentials left out. Free.
- [account_audit_log](https://conecto.chat/tools/account/account_audit_log.md): The account's admin and security actions, newest first, with a check that none was changed or removed. Free up to 1,000,000 reads a month.
- [account_save_team](https://conecto.chat/tools/account/account_save_team.md): Makes or changes a team: the areas its keys may use, a monthly budget that refuses or warns, and its ERP cost center code. $0.001 a call.
- [account_list_teams](https://conecto.chat/tools/account/account_list_teams.md): The account's teams with their areas, budgets, this month's spend, ERP codes, keys and people. Free up to 1,000,000 reads a month.
- [account_pause_team](https://conecto.chat/tools/account/account_pause_team.md): Stops every key of a team at once, until the owner starts it again. Free.
- [account_assign_team](https://conecto.chat/tools/account/account_assign_team.md): Gives a form, a number, an inbox or another thing to a team, so its charges land there. $0.001 a call.
- [account_set_owner_email](https://conecto.chat/tools/account/account_set_owner_email.md): Sends the business's owner a link to confirm they own the account, when it has no owner email yet. Free.
- [account_add_approval_rule](https://conecto.chat/tools/account/account_add_approval_rule.md): Makes a tool wait for a person's approval: every call, or calls over a limit, approved by an email, a channel or a team's managers. $0.001 a call.
- [account_list_approval_rules](https://conecto.chat/tools/account/account_list_approval_rules.md): The tools that wait for a person's approval, with their thresholds and approvers. Free up to 1,000,000 reads a month.
- [account_find_person](https://conecto.chat/tools/account/account_find_person.md): Every record the account holds about one person, by email or phone, with each kind's count and ids. Free.
- [account_export_person](https://conecto.chat/tools/account/account_export_person.md): One person's records and files in one ZIP in the file store, with a download link to give them. Free.
- [account_erase_person](https://conecto.chat/tools/account/account_erase_person.md): Erases one person across every area and says what it kept and why, like invoices the law keeps. Free.
- [account_data_locations](https://conecto.chat/tools/account/account_data_locations.md): Where each area's data is stored and processed: the company, the country or region, and what it holds. Free up to 1,000,000 reads a month.