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..

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
🚧

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

Google Mail (google-mail)

Use either threadId or other parameters (from, to, cc, bcc, subject, unread, starred, hasAttachment, receivedAfter, receivedBefore). These cannot be combined.

Outlook Mail (outlook-mail)

Use 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.

Query Params
string

Return messages sent from the specified email address.

string

Return messages sent to the specified email address.

string

Return messages that include the specified email address in the CC list.

string
Defaults to Return messages that include the specified email address in the BCC list.
string

Case-sensitive filter that returns messages with a matching (partial) subject.

string

Return messages in the specified thread.

boolean
Defaults to false
boolean
Defaults to false
boolean
Defaults to false
date

Return messages received after this ISO 8601

date-time

Return messages received after this ISO 8601

int32

pageSize is required to control size of results

string

pageToken fetches additional records; leave empty on the first request and use the next token from the previous response if more records exist.

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json