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.

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

Received at Date and time the email arrived.

Slug: received_at
Filter code: Gmail.getConversation.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.getConversation.MessageUrl
Type: Web URL
Example: https://mail.google.com/mail/#all/18c1a2b3d4e5f607

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.

Slug: conversation_url
Filter code: Gmail.getConversation.ConversationUrl
Type: Web URL
Example: https://mail.google.com/mail/#all/19ff0b2ef9fbb3d6

Get conversation

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

Query fields

Thread Text input > Other

Ingredients

Message Gmail's id for the message.

Thread Gmail's id for the conversation the message belongs to.

Message id header The email's RFC 822 Message-ID header, which is separate from Gmail's own id.

Subject The email's subject.

From name The sender's display name.

From The sender's email address.

To The To header of the email.

Cc The Cc header of the email. Empty when nobody was copied.

Bcc The Bcc header of the email. Received mail rarely carries one, so this is usually empty.

Reply to The Reply-To header, when the sender set one.

Body plain The email's body as plain text. Very long bodies are truncated.

Body html The email's body as HTML, when the email has one. Very long bodies are truncated.

Snippet A short preview of the email's content.

Has attachments Whether the email carries attachments: true or false.

Attachment count How many attachments the email carries.

Size estimate Gmail's estimate of the email's size in bytes.

Is unread Whether the email is unread: true or false.

Is important Whether Gmail marked the email important: true or false.

Is starred Whether the email is starred: true or false.

Category The inbox category Gmail sorted the email into: personal, social, promotions, updates or forums. Empty when the account has categories turned off.

Label ids Comma-separated list of the label ids on the email.

Received at Date and time the email arrived.

Message url Link that opens the email in Gmail.

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.

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.

Conversation url Link that opens the conversation in Gmail. The same value appears on every message of one lookup.

Applets using this Query