Outlook
Email List
List recent emails from one connected mailbox folder (Gmail/Outlook).
Endpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| rolestring · optional | string | optional | Read-status filter: all (default), seen (read only), unseen (unread only). One of: |
| limitnumber · optional | number | optional | Max results (default 20, maximum 50). Default: |
| sincestring · optional | string | optional | Only emails dated at or after this ISO date or date-time, e.g. "2026-09-22" or "2026-09-22T00:00:00Z". Use it for "in the last N days" / "since Monday" questions instead of filtering the newest page yourself. |
| untilstring · optional | string | optional | Only emails dated before this ISO date or date-time (exclusive). |
| cursorstring · optional | string | optional | The `cursor` of the previous result, when its `more` was true. Pass it with the same accountId, folder and since / until to read the next page; repeat until `more` is false. |
| folderstring · optional | string | optional | Folder to read: INBOX (the default when omitted), SENT, DRAFTS, TRASH or SPAM, or ALL to list every folder together, sent mail included. The result's `folder` says which was read. |
| providerstring · optional | string | optional | Mailbox provider kind: gmail, outlook or auto (default). This is NOT an account — to target one specific mailbox, use accountId. One of: |
| accountIdstring · optional | string | optional | The mailbox to use: an `account` value (name or address) from connector-list-accounts, which says whose each mailbox is. In chat, omit it when the person has one mailbox of their own; when several are available the call returns them so you can pick or ask. In a Workflow, a step uses only mailboxes the person who added it may use: omitting it picks their default (else newest) one, and a named one they may not use is refused, never replaced by another. |