Outlook Mark As Read

Controlled node

Overview

Marks a specific email as read in Microsoft Outlook. This node requires an active Outlook connection and the message ID of the email you want to mark as read. Use this after fetching emails to update their read status in the Outlook inbox.

Connection Required

This node requires a configured Outlook connection. Ensure you have set up an Outlook connection in your project settings before using this node.

Inputs

Input	Type	Description	Default
Run	Event	Triggers the node to mark the email as read.	-
Message ID	Text	The unique identifier of the Outlook email message to mark as read.	-
Connections	Connection	The Outlook connection to use for authentication.	-

Outputs

Output	Type	Description
Done	Event	Fires when the operation completes, regardless of success or failure.
Status	Text	Contains "marked as read" on success, or "failed: [error message]" on failure.

Runtime Behavior and Defaults

• Controlled Node: This node waits for the Run event to execute.
• Validation: The node validates that messageId is provided. If missing, it outputs "failed: \"messageId\" is required" and fires the Done event.
• Connection Handling: Uses the provided connection to authenticate with Microsoft Outlook via Microsoft Graph API.
• Error Handling: Any errors during the API call (e.g., invalid message ID, connection issues) are caught and returned in the status output with the prefix "failed: ".
• Idempotency: Marking an already-read email as read again will succeed without error.

Example Usage

Marking Fetched Emails as Read

A common pattern is to fetch emails, process them, and then mark them as read:

1. Use Outlook Get Inbox or Outlook Search Emails to retrieve messages
2. Extract the messageId from the email object (e.g., using a Get Value node)
3. Connect the messageId to the Outlook Mark As Read node's Message ID input
4. Connect the Connections input to your Outlook connection
5. Trigger the Run event to mark the email as read
6. Check the Status output to confirm success before proceeding

[Outlook Get Inbox] 
    ↓ (messages output)
[Get Value] → Extract messageId
    ↓
[Outlook Mark As Read] ← Connection: "My Outlook"
    ↓ (done event)
[If] ← Test: status == "marked as read"
    ↓ (true branch)
[Continue Processing]

Error Handling

To handle cases where marking as read fails:

1. Connect the Done event to an If node
2. Test if status starts with "failed" or equals "marked as read"
3. Route failed attempts to a retry mechanism or error logging workflow

Message ID Format

The Message ID should be the unique identifier string provided by Outlook (e.g., from the id field of email objects returned by other Outlook nodes). Do not confuse this with the internet message ID or thread ID.