Read a message
messages_getRead-only
Read one message in a connected mailbox, with its headers and its body. A message whose recipients one answer cannot carry names the first that fit, omittedRecipients counting the rest. The times it answers with carry their offset in the person's own time zone, which the answer names under now beside their time now in it - UTC where the person has stored no zone, as now says.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The message's id, as a search or a thread read answered it, or a draft's own id. | |
| view | No | full, the default, carries each message's text and attachments; summary leaves those out; headers leaves out the subject and snippet too. | |
| mailbox | Yes | The mailbox's name or its email address. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | Yes | ||
| id | Yes | ||
| to | Yes | ||
| bcc | Yes | ||
| now | Yes | The person's own time zone, in which every time this answer gives is written, and their time now in it. | |
| body | No | ||
| date | Yes | ||
| from | Yes | ||
| link | No | ||
| draft | Yes | ||
| focus | No | Outlook alone, on a message in the inbox: whether it sits in Focused or Other. | |
| folder | No | ||
| listId | No | On a message read alone, the mailing list it came from, as its List-Id header names it. | |
| unread | Yes | ||
| draftId | Yes | ||
| flagged | No | ||
| hasFile | No | Whether the message carries a file. | |
| replyTo | No | On a message read alone, where a reply goes in place of the sender, as its Reply-To names it. | |
| snippet | No | ||
| subject | No | ||
| answered | No | ||
| labelIds | Yes | ||
| threadId | Yes | ||
| important | No | Whether it is marked important: Gmail's own importance mark, Outlook's high importance. A password mailbox other than a Gmail keeps none. | |
| bodyFormat | No | ||
| categories | No | ||
| invitation | No | Whether it invites to a meeting or updates one; a cancellation or an answer to one does not. | |
| attachments | No | ||
| mailingList | No | Whether it names a mailing list it came from, in a List-Id or List-Unsubscribe header. | |
| unsubscribe | No | On a message read alone, where its sender takes requests to leave the list, as its List-Unsubscribe header names them - shown, never followed. | |
| authentication | No | On a message read alone, whether its sender passed authentication as the server that received it judged it, never as Lumman would: that server's DMARC result, on Outlook Microsoft's composite verdict - pass where the From address is proven. Absent where no server Lumman knows for the provider wrote one. | |
| omittedCharacters | No | ||
| omittedRecipients | No |