Skip to main content
Version: Current

Read Outlook Email

Description​

The Read Outlook Email activity retrieves emails from a Microsoft 365 (Outlook) mailbox using an Outlook connection.

This activity uses the Microsoft Graph API to read messages and can optionally mark them as read after processing.

Common Capabilities​

Process Data Support​

info

This activity supports dynamic configuration using variables from the Process Data drawer.

You can bind values from:

  • Model Data
  • Form Data
  • System Data
  • Enterprise Variables
  • Activity Outputs

Variables may be used directly or inside Liquid or JavaScript expressions where supported.

Learn more → Using Process Data

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 used to read emails.

Mail Folder​

Specifies the mail folder to read emails from (for example, Inbox, Sent Items, or Drafts).

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

Max Messages​

Specifies the maximum number of messages to retrieve in a single execution.

  • Default value: 10
  • Minimum value: 1

Read Only Unread Mails​

Controls whether only unread emails are retrieved.

  • true – Retrieves only unread emails (IsRead = false)
  • false – Retrieves all emails

Default value: true

Mark As Read​

Controls whether emails processed by this activity are marked as read.

  • true – Sets IsRead = true using Microsoft Graph
  • false – Leaves the read state unchanged

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​

Emails​

Returns a list of emails retrieved from the mailbox, serialized as JSON.

Each email object includes:

  • From – Sender email address
  • To – Recipient email addresses
  • Subject – Email subject
  • TextBody – Plain text content
  • HtmlBody – HTML content
  • ReceivedAt – Timestamp when the email was received
  • MessageId – Microsoft Graph message ID
  • InternalId – Internal unique identifier
  • Attachments – List of attachments with AttachmentReference

Count​

Returns the total number of emails read by the activity.