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.

For more information about the Microsoft Exchange Online connector A software component that allows seamless integration with third-party services, business applications, and content stores. Examples include Salesforce, Box, and Microsoft SharePoint. Connectors are used to create connections required for workflow and agentflow actions and start events., see Microsoft Exchange Online.

Configure the Microsoft Exchange Online - Received email start event

1. Open the Workflow designer. For more information, see Open the Workflow designer.

2. If the Start event configuration panel does not automatically open, click Start event. For more information, see Start event configuration panel.

   Important: 

   If invalid variables are detected, a message is displayed at the top of the Start event configuration panel. It can be due to changes that have been made to the start event, such as:

   • The start event configuration may have been changed.

   • The start event may have been changed completely. For example, the start event connector changed to a new connector or changed from a connector to a Nintex event.

   • The source configured in the start event configuration may have been changed or deleted. For example, after a workflow is configured to start when a new item is added to a SharePoint list, a column in the SharePoint list is deleted or the list is deleted.

   If you see this message it is recommended that you update the variables. You can update the variables or delete them as required in the Variables panel.

   If there are invalid references they will be deleted when the workflow is published. Deleting variables may result in unconfigured actions and you will have to update the configuration of the impacted actions.

3. In Start from, select Microsoft Exchange Online.

   Caution: After you have selected and configured your start event and you begin designing the workflow and using start event variables in any of your actions, you can no longer change Start from and Event.

   A warning message appears when one or more start event variables are referenced by actions within the workflow. The connector and event cannot be changed until the variables are no longer referenced within the workflow.

4. In Event, select Received email.

   The Configuration section is displayed to configure the start event.

5. Select a Connection. If you do not have a connection, see Add a connection.

6. (Optional) In Conditions, click Add condition to set conditions for the start event. Set conditions that start your workflow only when defined conditions are true. The Condition builder supports nested conditions, enabling you to create conditions within another condition. For fields and settings, see Condition builder.

   For each condition: 

   1. In When, select a start event variable. For example, select Name for a new file start event.
   2. In Operator, select an operator for comparing the variable to the value. For example, select Contains.

   3. If needed, in Value, type or select the value to use for the comparison. For example, type marketing.

   4. (Optional) Enter a Condition summary.

   5. Click Add condition.
   6. Select all or any to control how multiple conditions are evaluated.

View start event variables

Start event variables A variable associated with the start event. Often referenced by actions in the workflow. For example, a start event variable might capture input in a form field. are automatically added to the workflow. They are passed as parameters in the HTTP call to start the workflow.

At the top of the Start event configuration panel, click Show variables. The list of start event variables is populated.

Alternatively, click Hide variables to hide them.

The start event variables are contained in an object called Start variable and include the following variables:

• 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