Get email events
get_email_eventsRead-onlyIdempotent
Delivery/engagement timeline (sent→delivered→opened…) for one email.
Instructions
Delivery/engagement timeline (sent→delivered→opened…) for one email.
Chronological lifecycle events for a single email — use this to see
exactly what happened to one message (bounced? opened? clicked?)
rather than the account-wide aggregates ``get_email_stats`` returns.
Returns ``{"items": [...], "next_cursor": ...}`` where each item has
``kind`` (one of sent, delivered, delivery_delayed, bounced,
complained, rejected, opened, clicked), ``payload``, and
``occurred_at``. ``opened`` and ``clicked`` only occur for emails
sent with an HTML body. A plain-text-only email still gets sent,
delivered, and bounce events, but opens and clicks are never
tracked. Pass ``cursor`` from a previous ``next_cursor`` to
page (``limit`` 1..1000, default 100). On failure returns
``{"error": "resource not found"}`` for an unknown id.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"email_id": "<email_id>"
},
"name": "get_email_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| cursor | No | ||
| email_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||