This query returns the most recent emails matching your Gmail search, newest first.
Developer info
API endpoint slug
gmail.find_email
Runtime method
performQuery("gmail.find_email"}
Query fields
Query Text input > Other
Label
Gmail search query
Helper text
Accepts Gmail search syntax, for example from:boss@example.com has:attachment or in:sent to:jane@example.com. Plain text matches the subject, body, From and To only, so add cc: to match copied addresses too.
Slug
query
Required
true
Can have default value
true
Ingredients
Message
Gmail's id for the message.
Slug
message_id
Filter code
Gmail.findEmail.MessageId
Type
String
Example
19ff0b2ef9fbb3d6
Thread
Gmail's id for the conversation the message belongs to.
Slug
thread_id
Filter code
Gmail.findEmail.ThreadId
Type
String
Example
19ff0b2ef9fbb3d6
Message id header
The email's RFC 822 Message-ID header, which is separate from Gmail's own id.
Slug
message_id_header
Filter code
Gmail.findEmail.MessageIdHeader
Type
String
Example
<CAHFh0LsmJCyxzbEyAp4AXhLcpQ@mail.gmail.com>
Subject
The email's subject.
Slug
subject
Filter code
Gmail.findEmail.Subject
Type
String
Example
Project update
From name
The sender's display name.
Slug
from_name
Filter code
Gmail.findEmail.FromName
Type
String
Example
Jane Doe
From
The sender's email address.
Slug
from_address
Filter code
Gmail.findEmail.From
Type
String
Example
jane@example.com
To
The To header of the email.
Slug
to_address
Filter code
Gmail.findEmail.To
Type
String
Example
you@gmail.com
Cc
The Cc header of the email. Empty when nobody was copied.
Slug
cc
Filter code
Gmail.findEmail.Cc
Type
String
Example
team@example.com
Bcc
The Bcc header of the email. Received mail rarely carries one, so this is usually empty.
Slug
bcc
Filter code
Gmail.findEmail.Bcc
Type
String
Example
hidden@example.com
Reply to
The Reply-To header, when the sender set one.
Slug
reply_to
Filter code
Gmail.findEmail.ReplyTo
Type
String
Example
no-reply@example.com
Body plain
The email's body as plain text. Very long bodies are truncated.
Slug
body_plain
Filter code
Gmail.findEmail.BodyPlain
Type
String
Example
Here is the latest update on the project.
Body html
The email's body as HTML, when the email has one. Very long bodies are truncated.
Slug
body_html
Filter code
Gmail.findEmail.BodyHTML
Type
String
Example
<p>Here is the latest update on the project.</p>
Snippet
A short preview of the email's content.
Slug
snippet
Filter code
Gmail.findEmail.Snippet
Type
String
Example
Here is the latest update on the...
Has attachments
Whether the email carries attachments: true or false.
Slug
has_attachments
Filter code
Gmail.findEmail.HasAttachments
Type
String
Example
false
Attachment count
How many attachments the email carries.
Slug
attachment_count
Filter code
Gmail.findEmail.AttachmentCount
Type
String
Example
2
Attachment filenames
Comma-separated filenames of the attachments.
Slug
attachment_filenames
Filter code
Gmail.findEmail.AttachmentFilenames
Type
String
Example
report.pdf, photo.jpg
Attachment types
Comma-separated MIME types, in the same order as AttachmentFilenames.
Slug
attachment_types
Filter code
Gmail.findEmail.AttachmentTypes
Type
String
Example
application/pdf, image/jpeg
Attachment sizes
Comma-separated sizes in bytes, in the same order as AttachmentFilenames.
Slug
attachment_sizes
Filter code
Gmail.findEmail.AttachmentSizes
Type
String
Example
52133, 384002
Size estimate
Gmail's estimate of the email's size in bytes.
Slug
size_estimate
Filter code
Gmail.findEmail.SizeEstimate
Type
String
Example
6959
Is unread
Whether the email is unread: true or false.
Slug
is_unread
Filter code
Gmail.findEmail.IsUnread
Type
String
Example
true
Is important
Whether Gmail marked the email important: true or false.
Slug
is_important
Filter code
Gmail.findEmail.IsImportant
Type
String
Example
false
Is starred
Whether the email is starred: true or false.
Slug
is_starred
Filter code
Gmail.findEmail.IsStarred
Type
String
Example
false
Category
The inbox category Gmail sorted the email into: personal, social, promotions, updates or forums. Empty when the account has categories turned off.
Slug
category
Filter code
Gmail.findEmail.Category
Type
String
Example
personal
Label ids
Comma-separated list of the label ids on the email.
This query returns the most recent emails matching your Gmail search, newest first.