List messages

Retrieves all messages sent or received by the user in a paginated format. Supports various filters such as subject, from, to, cc, bcc, date range, folder, and labels to narrow down the response results..

🚧

Use Get message by Id API for additional details

This API may not return all fields defined in the response schema; for additional details, use the Get message by Id API

ℹ️

Pagination behavior

  • Default pageSize is 10
  • For fetching next set of records always use pageToken
  • Filters applied in initial request are honored, so keep filters same for subsequent request

Supported Apps

Here is the list of apps that supports this API

AppApp IDRemarks
Google Mailgoogle-mailUse either threadId or other parameters (from, to, cc, bcc, subject, unread, starred, hasAttachment, receivedAfter, receivedBefore). These cannot be combined.
Outlook Mailoutlook-mailUse either parameters like to, cc, bcc, subject or parameters like from, threadId, unread, hasAttachments, receivedAfter, receivedBefore. These cannot be used together. If both are provided, only the first group will be used.
Language
Credentials
Click Try It! to start a request and see the response here!