Find outgoing emails
list_sentFind saved outgoing emails using combined search and filters.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| from | No | Exact email address in From, case-insensitive; not the SMTP envelope sender. | |
| after | No | Inclusive receipt/submission time: YYYY-MM-DDTHH:mm:ss, optional 1–3 fractional digits, then Z or ±HH:mm. | |
| limit | No | ||
| order | No | Defaults to newest. Relevance requires query; ties use newest first. Threads order by their latest activity. | |
| query | No | Match all words or quoted phrases in subject/body. Case-insensitive keyword search, not semantic similarity; up to 16 terms/phrases. | |
| before | No | Exclusive receipt/submission time: YYYY-MM-DDTHH:mm:ss, optional 1–3 fractional digits, then Z or ±HH:mm. | |
| cursor | No | Continue with next_cursor from the previous result, keeping the same filters. Stop when next_cursor is null. | |
| subject | No | Literal case-insensitive substring of the subject. | |
| inbox_id | Yes | ||
| recipient | No | Exact email address in To/Cc/Bcc where available, case-insensitive. | |
| labels_all | No | Require every listed label. Filter groups combine with AND; empty arrays impose no condition. | |
| labels_any | No | Require at least one listed label. | |
| labels_none | No | Exclude messages with any listed label. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| messages | Yes | ||
| next_cursor | Yes |