Outlook icon

Outlook

Manage Microsoft Graph Outlook subscriptions, messages, and attachments

Actions25

Message → Get

AI-generated

Summary

Retrieves one Outlook message by ID, or lists messages from a mailbox when the ID is empty. You can narrow a listing by folder or filter, choose returned fields and sort order, and include or download attachments.

Inputs

  • Mailbox — Choose the current mailbox or an other mailbox. For an other mailbox, provide its email address.
  • Message ID — ID of the message to retrieve. Leave empty to list messages.
  • Use Immutable ID — Treat the supplied message ID as an immutable ID; adds the Microsoft Graph IdType="ImmutableId" preference header.
  • Options — For listings, configure a client-side filter, sort order, selected fields, folder, and maximum number of messages (1–1000). For either mode, you can request expanded custom extended properties by name, convert returned HTML body content to Markdown, and include or download attachment data. Attachment downloading also includes attachment metadata.

Output shape

A list of n8n items, each containing a message object; with attachment downloads enabled, file contents are added as binary data.

A supplied Message ID retrieves one message; an empty ID lists messages, limited to 25 by default. Folder, filter, order, and limit apply only to listings. Selected fields default to all fields when none are chosen. Markdown is added only when the returned body is HTML and includes the body field. Attachments are included by default, and downloaded file content is exposed as binary properties such as data_0 and data_1.

Examples

Example 1: Retrieve one message by ID and download its attachments.

Provide the message ID and leave attachment listing and downloading enabled.

Example 2: List up to 50 unread messages from a specific folder, newest first.

Leave Message ID empty, set the folder, add a filter for isRead=false, set Order By to Received (Newest First), and set Limit to 50.

Links

Discussion