list_threads
Retrieve and organize email threads from your Gmail mailbox, filtering by labels, queries, or spam/trash. Customize results with HTML body inclusion and pagination for efficient thread management.
Instructions
List threads in the user's mailbox
Input Schema
Name | Required | Description | Default |
---|---|---|---|
includeBodyHtml | No | Whether to include the parsed HTML in the return for each body, excluded by default because they can be excessively large | |
includeSpamTrash | No | Include threads from SPAM and TRASH in the results | |
labelIds | No | Only return threads with labels that match all of the specified label IDs | |
maxResults | No | Maximum number of threads to return | |
pageToken | No | Page token to retrieve a specific page of results | |
q | No | Only return threads matching the specified query |