Gmail
Email List
List recent emails from one connected mailbox folder (Gmail/Outlook).
1 creditRuns in your Gmail accountEndpoint
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 | Pagination cursor returned by the previous call for fetching the next page. |
| folderstring · optional | string | optional | Folder filter (INBOX|SENT|DRAFTS|TRASH|SPAM). Default INBOX. |
| 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, omitting it uses the workspace default. |