Get email events
get_email_eventsRead one email's delivery and engagement timeline.
Events include sent, delivered, delivery_delayed, bounced, complained,
rejected, opened and clicked, with ``payload`` and ``occurred_at``.
Open and click events require an HTML email body.
Returns ``items`` and ``next_cursor``, or an error.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 | How many items one page holds. ``next_cursor`` in the response points to the next page. Omitted: the API returns 100. | |
| cursor | No | Pagination cursor: the ``next_cursor`` from the previous page. Omitted: the first page. | |
| email_id | Yes | Email ID, from ``send_email`` or ``list_emails``. | |
| llm_model | No | Model ID of the calling agent. Optional. Recorded for analytics only. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||