Search Emails

Search for an email or multiple emails. For more information, refer to Gmail Documentation.


Field Definition Type Required
Result Set

Choose from:

  • First matching email: return the first email message that meets the search criteria
  • All matching emails: return all email messages that match the search criteria
Dropdown TRUE


Field Definition Type Required
Query Return only the messages that match the specified query (supports the same query format as the Gmail search box, such as is:unread. See Search operators you can use with Gmail. String FALSE
With Labels Labels to include in message filtering (such as Important, Starred, or Spam). List FALSE
Include Spam and Trash Set to True to include spam and trash messages, or False to exclude them. Boolean FALSE


Field Definition Type
Result for First Matching Email
Message ID Unique ID of the message String
Subject Subject of the message String
Text Body Text in the body of the message String
HTML Body HTML formatted body of the message String
To Email addresses of the message recipients (format multiple addresses in a list of individual emails or as a single text string separated by commas or semicolons) String
From Sender of the message String
CC A list of carbon copied recipients List
Labels List of categories attributed to the message (for example, Unread, or Important) List
Result for All Matching Emails
Emails List of email objects returned from the search, where each object contains the fields described in the First Matching Email section List

Related topics

Gmail connector

About the elements of Okta Workflows

Gmail API documentation