List received emails
list_received_emailsRead incoming mail for an account's domains, newest first, and filter by recipient, sender, or search string. Each result includes a clear, review, or unavailable verdict and reasons.
Instructions
Purpose: read mail that arrived at this account’s domains, newest first. Filter by recipient, sender, or a search string. Each row carries verdict (clear, review, or unavailable) and the reasons. Held messages are left out unless include_held is true. A held message is waiting for a person to release it; it is not in the arrival webhook yet. NOT for: mail you sent (list_emails), grouping a conversation (list_threads), or sending a reply (reply_to_email). Returns: data, has_more, and next_cursor. Page again by passing next_cursor as cursor; when has_more is false you have everything.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_received_emails"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Search the subject, either address, or the start of the message id. | |
| to | No | Only mail delivered to this address. | |
| from | No | Only mail from this address. | |
| limit | No | Page size (1-100). | |
| since | No | Only mail received at or after this instant (ISO-8601 with an offset). | |
| until | No | Only mail received at or before this instant (ISO-8601 with an offset). | |
| cursor | No | next_cursor from the previous page. Omit for the first page. | |
| include_held | No | Set true to include messages a person has not released yet. Omitted, those messages are left out. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | This page of rows. | |
| 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. | |
| has_more | No | True when another page follows. | |
| next_cursor | No | Pass back as cursor for the next page; null on the last page. |