List Threads
List Gmail threads with optional search, labels, and paging.
Type
google.gmail.list_threadsListed only when a matching connected service is enabled.
List Threads returns thread ids and snippets. It does not return full bodies. Follow with Get Thread.
Search uses the same syntax as the Gmail search box. Type a query in one line and insert context with {{ }} (for example from:{{ args.email }} newer_than:7d).
Configure
| Setting | Description |
|---|---|
| Search query (optional) | Gmail search string. Liquid template, for example from:{{ args.email }} is:unread |
| Label IDs (optional) | Comma-separated label ids, for example INBOX,UNREAD |
| Max results | Page size, 1–500. Default 20 if empty |
| Page token (optional) | nextPageToken from a previous list |
| Include spam and trash | When on, spam and trash can appear in results |
Handles
| Handle | Role |
|---|---|
| In (target) | Incoming connection |
| Out (source) | Continues after the list returns |
Pipe schema
| Key | Type | Description |
|---|---|---|
threads | list | Each item has id, snippet, historyId |
nextPageToken | text | Pass to the next list for the following page |
resultSizeEstimate | number | Approximate match count |