List emails
list_emailsRetrieve recent emails newest first with optional filters for date range, status, and search to review message activity or locate specific sends.
Instructions
List recent emails, newest first, with optional filters. Needs read access: a full-access API key, or the read permission when signed in.
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_emails"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Only emails from the last N days | |
| limit | No | 1 to 100, default 20 | |
| before | No | Return emails older than this email ID (paging) | |
| search | No | Search recipient, sender or subject | |
| status | No |