Outlook Get Inbox

Controlled node

Overview

Fetches email messages from the Outlook inbox for a connected Microsoft account. This node retrieves messages with support for pagination through limit and offset parameters, allowing you to fetch specific batches of emails.

There is a hard limit of 500 messages that can be fetched per execution. The node requires an active Outlook connection configured in the project connections.

Output format

The messages output returns an array of email objects containing standard Outlook message fields including:

• id - The message identifier
• subject - Email subject line
• body - Email body content
• from - Sender information
• to - Recipient information
• receivedDateTime - Timestamp when received
• hasAttachments - Boolean indicating if attachments exist

Message fetch limit

You cannot fetch more than 500 messages in a single execution. If you need to retrieve more messages, use the offset parameter to paginate through results in multiple workflow runs.

Inputs

Input	Type	Description	Default
Run	Event	Fires when the node starts running	-
Limit	Number	Maximum number of messages to fetch (max 500)	100
Offset	Number	Number of messages to skip (for pagination)	0

Properties

Property	Type	Description	Default
Connections	Connection	The Outlook connection to use for fetching emails	-

Outputs

Output	Type	Description
Done	Event	Fires when the node has finished executing
Messages	Data	Array of email message objects from the inbox

Runtime behavior and defaults

When triggered, the node validates that the limit does not exceed 500 messages (including offset). If the limit exceeds this maximum, the node outputs an error message instead of fetching data.

The node uses the Microsoft Graph API through the configured Outlook connection to retrieve messages from the inbox folder. If the connection is invalid or expired, the node will output an error.

By default, the node fetches the 100 most recent messages (limit: 100, offset: 0). Use the offset parameter to paginate through larger inboxes - for example, set offset to 100 to fetch the next 100 messages.

Example usage

Basic inbox fetch Connect a Start node to the Run input of Outlook Get Inbox. Configure the Connections property with your Outlook connection. The node will output the 100 most recent messages via the Messages output when executed.

Paginated fetch To fetch messages in batches:

1. Set Limit to 50 to fetch 50 messages at a time
2. Set Offset to 0 for the first batch
3. Store the results and increment Offset by 50 for subsequent runs
4. Continue until fewer than 50 messages are returned (indicating end of inbox)

Processing attachments Connect the Messages output to a For Each node to iterate through individual messages. Check the hasAttachments field on each message, and if true, use the Outlook Get Attachments node to retrieve the attachment files.