Close menu
Explore Plans
Mobile menu Close menu
Back
Gmail

Find email

Pro plus icon 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.

Slug
label_ids
Filter code
Gmail.findEmail.LabelIds
Type
String
Example
UNREAD, IMPORTANT, INBOX

Received at Date and time the email arrived.

Slug
received_at
Filter code
Gmail.findEmail.ReceivedAt
Type
Date with time (ISO8601)
Example
2020-07-08T04:17:06+05:00

Message url Link that opens the email in Gmail.

Slug
message_url
Filter code
Gmail.findEmail.MessageUrl
Type
Web URL
Example
https://mail.google.com/mail/#all/18c1a2b3d4e5f607

Applets using this Query