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

ParameterDescription
QueryOnly 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.
Return All PagesAutomatically fetch all resources, page by page.
User IDThe user’s email address. The special value me can be used to indicate the authenticated user.

Advanced Parameters

ParameterDescription
Delegated User OverridePerform 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 SizeMaximum number of messages to return. The maximum allowed value for this field is 500.
Page TokenThe page token allows you to get a specific page of results in a list. If additional pages are available, the response will include a nextPageToken that you can use to fetch the next page of results.

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