List Gmail Messages

Lists the messages in the user's mailbox. Please note that the action can only retrieve the data of the user specified in the connection.

External Documentation

To learn more, visit the Gmail documentation.

Basic Parameters

Parameter	Description
Query	Only return messages matching the specified query. Supports the same query format as the Gmail search box. For example, "from:someuser@example.com rfc822msgid: is:unread". Parameter cannot be used when accessing the api using the gmail.metadata scope.
User ID	The user's email address. The special value me can be used to indicate the authenticated user.

Advanced Parameters

Parameter	Description
Delegated User Override	Perform the action on behalf of another user, overriding the delegated user defined in the connection. If not specified, the delegated user is the one provided in the connection. Has no effect when using an OAuth connection. NOTE: the connection details are not edited by this input.
Page Size	Maximum number of messages to return. This field defaults to 100. The maximum allowed value for this field is 500.

Example Output

{
    "messages": [
        {
            "id": "18476a3a2a1f3e2d",
            "threadId": "18476a3a2a1f3e2d"
        },
        {
            "id": "18476a392793ce57",
            "threadId": "18476a392793ce57"
        },
        {
            "id": "1847693063d1262e",
            "threadId": "1847693063d1262e"
        },
        {
            "id": "1847692f6c487fad",
            "threadId": "1847692f6c487fad"
        }
    ],
    "nextPageToken": "13224725121085952498",
    "resultSizeEstimate": 201
}

Workflow Library Example

Search Gmail Ioc Across Emails

Preview this Workflow on desktop