List Messages

Lists messages in Microsoft Outlook 365.

This node is also exposed as an AI Agent tool.

This node has 1 input port and 1 output port.

Common Properties

Every node shares these.

• Name — the node's display name on the canvas.
• Color — the node's colour on the canvas.
• Delay Before (sec) — wait this long before the node runs.
• Delay After (sec) — wait this long after the node runs.
• Continue On Error — carry on instead of failing the flow. Defaults to false.

info

When Continue On Error is true the error is not raised at all, so a Catch node will not see it either.

Inputs

Property	Field	Description
Folder	inFolderID	Mail folder: inbox٫ drafts٫ sentitems٫ deleteditems٫ or folder ID. Leave empty for inbox

Outputs

Property	Field	Description
Messages	outMessages	List of email messages

Options

Property	Field	Description
Credentials	inCredentials	Microsoft 365 credentials (OAuth2 or Service Account)
Mark as Read	optMarkAsRead	Mark retrieved messages as read
Unread Only	optUnreadOnly	Only retrieve unread messages

Requirements

• Azure AD App (Client Credentials) — Use Azure AD app registration with client credentials for server-to-server authentication.
  • tenant_id — Tenant ID (text, required). Azure AD tenant ID (Directory ID)
  • client_id — Application (Client) ID (text, required). Azure AD application (client) ID
  • client_secret — Client Secret (password, required). Azure AD application client secret
  • user_email — User Email (text, required). Email of the user whose mailbox to access. Required for client credentials flow.
• OAuth2 (Delegated) — Authorize via browser to access Outlook on behalf of a user.
  • _redirect_url — Redirect URL (readonly, optional). Add this to your Azure app's Redirect URIs
  • tenant_id — Tenant ID (text, required). Azure AD tenant ID٫ or 'common' for multi-tenant
  • client_id — Application (Client) ID (text, required). Azure AD application (client) ID
  • client_secret — Client Secret (password, required). Azure AD application client secret

Store these in a Vault and reference the vault item from the node, rather than typing the secret into the property.

Related nodes

Get Message · Search Messages · Send Mail · Reply to Message · Forward Message · Delete Message · Move Message · Get Attachments

Elsewhere in the package: List Folders · Get Folder · List Events · Get Event · Create Event · Update Event · Delete Event · List Meetings · Get Meeting · Toolkit

See also

• Microsoft Outlook 365 — every node in this package
• Message object — how properties read values from msg
• Handling failure — Continue On Error, Catch and retries