This query returns the messages in a Gmail conversation, looked up by its thread id: one result per message, oldest first, each carrying the message's full content alongside the conversation's participants and message count.
Developer info
API endpoint slug
gmail.get_conversation
Runtime method
performQuery("gmail.get_conversation"}
Query fields
Thread Text input > Other
Label
Thread ID
Helper text
The conversation to look up. Use the ThreadId ingredient from a Gmail trigger or query.
Slug
thread_id
Required
true
Can have default value
true
Ingredients
Message
Gmail's id for the message.
Slug
message_id
Filter code
Gmail.getConversation.MessageId
Type
String
Example
19ff0b2ef9fbb3d6
Thread
Gmail's id for the conversation the message belongs to.
Slug
thread_id
Filter code
Gmail.getConversation.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.getConversation.MessageIdHeader
Type
String
Example
<CAHFh0LsmJCyxzbEyAp4AXhLcpQ@mail.gmail.com>
Subject
The email's subject.
Slug
subject
Filter code
Gmail.getConversation.Subject
Type
String
Example
Project update
From name
The sender's display name.
Slug
from_name
Filter code
Gmail.getConversation.FromName
Type
String
Example
Jane Doe
From
The sender's email address.
Slug
from_address
Filter code
Gmail.getConversation.From
Type
String
Example
jane@example.com
To
The To header of the email.
Slug
to_address
Filter code
Gmail.getConversation.To
Type
String
Example
you@gmail.com
Cc
The Cc header of the email. Empty when nobody was copied.
Slug
cc
Filter code
Gmail.getConversation.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.getConversation.Bcc
Type
String
Example
hidden@example.com
Reply to
The Reply-To header, when the sender set one.
Slug
reply_to
Filter code
Gmail.getConversation.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.getConversation.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.getConversation.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.getConversation.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.getConversation.HasAttachments
Type
String
Example
false
Attachment count
How many attachments the email carries.
Slug
attachment_count
Filter code
Gmail.getConversation.AttachmentCount
Type
String
Example
2
Size estimate
Gmail's estimate of the email's size in bytes.
Slug
size_estimate
Filter code
Gmail.getConversation.SizeEstimate
Type
String
Example
6959
Is unread
Whether the email is unread: true or false.
Slug
is_unread
Filter code
Gmail.getConversation.IsUnread
Type
String
Example
true
Is important
Whether Gmail marked the email important: true or false.
Slug
is_important
Filter code
Gmail.getConversation.IsImportant
Type
String
Example
false
Is starred
Whether the email is starred: true or false.
Slug
is_starred
Filter code
Gmail.getConversation.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.getConversation.Category
Type
String
Example
personal
Label ids
Comma-separated list of the label ids on the email.
Participants
Comma-separated email addresses of everyone on the conversation, in order of first appearance. The same value appears on every message of one lookup.
Slug
participants
Filter code
Gmail.getConversation.Participants
Type
String
Example
jane@example.com, you@gmail.com
Message count
How many messages the conversation holds at lookup time, which can exceed the number of returned messages. The same value appears on every message of one lookup.
Slug
message_count
Filter code
Gmail.getConversation.MessageCount
Type
String
Example
3
Conversation url
Link that opens the conversation in Gmail. The same value appears on every message of one lookup.
This query returns the messages in a Gmail conversation, looked up by its thread id: one result per message, oldest first, each carrying the message's full content alongside the conversation's participants and message count.