Get a received email
get_received_emailRead a single received email by ID to inspect headers, text and HTML bodies, delivery verdict with reasons, and attachment metadata, including held messages only when requested.
Instructions
Purpose: read one received email — headers, text and HTML bodies as data, the verdict (clear, review, or unavailable) with its reasons, and the attachments it carried. A held message is left out unless include_held is true. Held mail is waiting for a person to release it and is not in the arrival webhook yet. NOT for: listing (list_received_emails) or sending a reply (reply_to_email). The HTML is what a stranger sent; it is not rendered here. Returns: the message, its headers, both bodies, extracted_text and extracted_html (the reply with quoted history, signatures and footers removed; null when that cut could not be produced, in which case read text then html), inbound_verdict, and attachment metadata. Attachment bytes are a REST download, not this tool. A list does not include the extracted fields.
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": {
"received_id": "<received_id>"
},
"name": "get_received_email"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| received_id | Yes | The id from list_received_emails. | |
| include_held | No | Set true to read a message a person has not released yet. Omitted, a held message is left out. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Identifier. | |
| html | No | The HTML part as it arrived. | |
| text | No | The plain-text part as it arrived. | |
| error | No | Present instead of the fields above when the call was refused: code, message, fix, docs_url, retryable and, when waiting helps, retry_after_seconds. | |
| extracted_html | No | The same cut, in HTML. Null when the message had no HTML or extraction produced nothing. | |
| extracted_text | No | The reply with quoted history, signatures and footers removed. Null when extraction produced nothing; read text, then html. |