list_emails_metadata
Retrieve email metadata including ID, subject, sender, recipients, and date without body content. Filter by mailbox, date range, subject, sender, recipient, read/flagged/answered status, and paginate results.
Instructions
List email metadata (email_id, subject, sender, recipients, date) without body content. Returns email_id for use with get_emails_content.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account_name | Yes | The name of the email account. | |
| page | No | The page number to retrieve (starting from 1). | |
| page_size | No | The number of emails to retrieve per page. | |
| before | No | Retrieve emails before this datetime (UTC). | |
| since | No | Retrieve emails since this datetime (UTC). | |
| subject | No | Filter emails by subject. | |
| from_address | No | Filter emails by sender address. | |
| to_address | No | Filter emails by recipient address. | |
| order | No | Order emails by field. `asc` or `desc`. | desc |
| mailbox | No | The mailbox to search. | INBOX |
| seen | No | Filter by read status: True=read, False=unread, None=all. | |
| flagged | No | Filter by flagged/starred status: True=flagged, False=unflagged, None=all. | |
| answered | No | Filter by replied status: True=replied, False=not replied, None=all. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | ||
| page_size | Yes | ||
| before | Yes | ||
| since | Yes | ||
| subject | Yes | ||
| emails | Yes | ||
| total | Yes |