Get Message
gmail.get_message
ActionEmailconnection required
Calls the Gmail API messages.get (format=full).
Fetch one Gmail message (headers, body, attachment list) by id.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- OAuth 2.0
- Providers
- Gmail
- Secret shape
- {"client_id", "client_secret", "refresh_token"}
- Resolved by
- config.connection_id, else node.connection_id
Configuration
1 field, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
message_id Gmail message id. Supports {{ }}. | string | Yes | — | — | — |
Output
One shape.
message
| Field | Type | Example |
|---|---|---|
ok | boolean | — |
message_id Gmail's message id (not the RFC Message-ID). | string | — |
thread_id Pass to gmail.reply / gmail.send to stay in the thread. | string | — |
from | string | Ada <ada@example.com> |
to | string | — |
cc | string | — |
bcc | string | — |
reply_to The Reply-To header — where a reply must actually go. | string | — |
subject | string | — |
date The Date header. | string | — |
snippet First ~100 chars, as Gmail shows it. | string | — |
body Plain-text body (HTML stripped when no text part). | string | — |
internal_date Receive time, epoch milliseconds. | number | — |
label_ids | array | — |
rfc_message_id The RFC 822 Message-ID, for In-Reply-To. | string | — |
in_reply_to | string | — |
references | string | — |
history_id | string | — |
size_estimate Gmail's estimated message size in bytes. | number | — |
attachments One entry per attached file. | array | — |
attachments[].filename | string | — |
attachments[].mime_type | string | — |
attachments[].size | number | — |
attachments[].attachment_id Feed to gmail.get_attachment. | string | — |
attachments[].part_id | string | — |
{
"attachments": [
{
"attachment_id": "",
"filename": "",
"mime_type": "",
"part_id": "",
"size": 0
}
],
"bcc": "",
"body": "",
"cc": "",
"date": "",
"from": "Ada <ada@example.com>",
"history_id": "",
"in_reply_to": "",
"internal_date": 0,
"label_ids": [],
"message_id": "",
"ok": false,
"references": "",
"reply_to": "",
"rfc_message_id": "",
"size_estimate": 0,
"snippet": "",
"subject": "",
"thread_id": "",
"to": ""
}Templates that use Gmail
Solutions with Gmail
See Get Message run in a workflow.
In a technical demo we add the Gmail connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.