Skip to main content
Version: Current

Mark Outlook Email Read/Unread

Description​

The Mark Outlook Email Read/Unread activity updates the read status of an email in a Microsoft 365 (Outlook) mailbox using an Outlook connection.

This activity modifies the IsRead property of the email identified by its Microsoft Graph message ID.

Common settings​

Use Process Data to bind supported inputs to workflow values or upstream outputs. See Common Activity Features for shared execution, error-handling, and output-persistence settings. Availability depends on the activity.

Design-Time Configuration​

Display Text​

Specifies the activity's display name as shown on the workflow canvas.

Connection Name​

Specifies the Outlook (Microsoft 365) connection to use for updating the email read state.

Mail Folder​

Specifies the mail folder that contains the email (for example, Inbox, Sent Items, or Drafts).

  • If left empty, the default folder configured in the Outlook connection is used.
  • Default value: empty.

Message Identifier​

Specifies the Microsoft Graph Message ID of the email to update.

Use the MessageId value returned by the Read Outlook Email activity.

Mark As Read​

Controls whether the email is marked as read or unread.

  • true – Marks the email as read (IsRead = true)
  • false – Marks the email as unread (IsRead = false)

Default value: true

Execution Control (Wait All Incoming)​

Controls how the activity behaves when multiple incoming execution paths converge.

For detailed behavior and usage guidance, see   Execution Control – Wait All Incoming.

Error Handling (On Error)​

Defines how the workflow proceeds if the activity encounters an error.

Supported strategies include Fault, Continue, Suspend, and Retry.

For details, see   On Error Handler.

Output​

Updated Email​

Returns the email whose read state was updated (if found), serialized as JSON.

The output includes:

  • From
  • To
  • Subject
  • TextBody
  • HtmlBody
  • ReceivedAt
  • MessageId
  • InternalId
  • Attachments

Example: Use a read result​

Read messages with Read Outlook Email and iterate over Emails. Bind the current email's MessageId to Message Identifier. Use the same connection that produced the message.

Set Mark As Read to True for read or False for unread. Marking a message unread can make it eligible for a later unread-only read.

Do not bind InternalId: it contains the Internet Message-ID header rather than the mailbox lookup key. See Message identifiers. A message that cannot be found can return an empty email output; handle activity errors separately from a missing result.

Help improve this page