Microsoft Exchange Online - Received email

Use the Microsoft Exchange Online - Received email start event An event that triggers a workflow to run when it occurs. An example is Box - New file, which triggers the workflow to run when a new file is uploaded to the specified folder. to start your workflow whenever an email is received on a specified Microsoft Exchange Online account.

Microsoft Exchange Online has other start events as well as actions. For more information, see Microsoft Exchange Online.

Before you begin:

Understand the Start event configuration panel
Understand Variables
Learn about Handling files in your workflow

Jump to:

Select the Microsoft Exchange Online - Received email start event
Configure the start event
Microsoft Exchange Online - Received email start event variables
Microsoft Exchange Online - Received email start event fields and settings

Select the Microsoft Exchange Online - Received email start event

At the top of the designer canvas on the Designer page, click Start event to open the Start event configuration panel.
In the Start from drop-down list, select Microsoft Exchange Online.
For Event, select Microsoft Exchange Online - Received email.

Additional fields appear. To configure, see Configure the start event.

Configure the start event

In the Start event configuration panel:

Find the Source section.
Select a Connection. If you do not have a connection, see Add a connection.

Caution: Changing the account for the connection, will cause the received email start event to not start and will require you to create a new connection and then change the connection on the received email event.

For more information on the fields and buttons, see Microsoft Exchange Online - Received email start event fields and settings.

Microsoft Exchange Online - Received email start event variables

You can view the start event variables automatically added to the workflow.

In the designer canvas, click Start event to open the configuration panel.
Click Show variables.

Start event objects and variables

Note: These are the variables displayed for a list with the default columns available when you create a new list in Microsoft Exchange Online. If the list you select has additional columns there will be more start event variables displayed depending on the columns.

Body(content): (Text) The body of the message. It can be in HTML or text format.
Body(content type): (Text)
Categories: (Collection) The categories associated with the message.
Categories: (Text) The categories associated with the message.
CC recipients: (Collection) The Cc: recipients for the message.
- Email Address: (Object)
  - Email: (Text)
  - Name: (Text)
CC recipients(all display names): (Text) The Cc: recipients for the message.
CC recipients(all email addresses): (Text) The Cc: recipients for the message.
From(display name): (Text) The owner of the mailbox from which the message is sent.
Has attachments: (Boolean) Indicates whether the message has attachments.
ID: (Text) Unique identifier for the message.
Importance: (Text) The importance of the message. The possible values are: low, normal, and high.
Received date: (DateTime) The date and time the message was received.
Reply to: (Collection) The email addresses to use when replying.
- Email Address: (Object)
  - Email: (Text)
  - Name: (Text)
Reply to (all display names): (Text) The email addresses to use when replying.
Reply to (all email addresses): (Text) The email addresses to use when replying.
Sender(display name): (Text) The account that is actually used to generate the message.
Sender(email address): (Text) The account that is actually used to generate the message.
Sent date: (DateTime) The date and time the message was sent.
Subject: (Text) The subject of the message.
To recipients: (Collection) The To: recipients for the message.
- Email Address: (Object)
  - Email: (Text)
  - Name: (Text)
To recipients all display names: (Text) The To: recipients for the message.
To recipients all email addresses: (Text) The To: recipients for the message.

Microsoft Exchange Online - Received email start event fields and settings

Section	Field	Description
	Event	Lists events for the selected connector.
Configuration	Connection	The Microsoft Exchange Online connection to use for the start event.
Conditions	Add condition	Displays fields for defining a new condition.
	When	The start variable that the operator compares with the value.
	Operator	How the When variable and Value are compared. Select from the drop-down. The operators available in the drop-down depend on the When variable type. For example, you want your workflow to start when the sender's email address contains the word John. In the condition: 'When Sender email contains John, the operator is contains.
	Value	The text or variable that the operator compares with the When variable. Type to enter text. The variable type must match the When variable type. Example: in the condition: 'When Sender email contains John, the operator is contains, the value is John.
	Add	Saves the condition to the start event.
	Cancel	Discards the condition you are editing.
	all/any	If you select: all: then all conditions must be true for the workflow to start. any: then at least one of the multiple conditions must be true for the workflow to start.
	(Edit condition)	Re-displays condition fields for editing.
	(Delete condition)	Deletes the indicated condition.