Outlook component

Overview

The Outlook component allows Connect to work with Microsoft Outlook, a personal information manager web app consisting of webmail, calendar, contacts, and tasks services features.

API version

The Outlook component uses version 1.0 of the Microsoft Graph REST API.

Prerequisites

Credentials

To create new credentials, you need to authorize within the Microsoft system using the OAuth2 protocol.

Read the documentation on the Creating OAuth2 app page for information on how to do this.

Triggers

Contacts

This triggers a poll of all new contacts in Outlook since it was last polled. The lastModifiedDateTime contact property provides polling. It is possible to poll up to 900 contacts in every execution.

Poll for new mail

This triggers a poll of all new mail from a specified folder since it was last polled. The 'lastModifiedDateTime` mail property provides polling.

Poll for New Mail

You can poll up to 1000 emails in every execution using default settings. This amount can only be changed by the Product team. A premium component needs to be deployed to a Contract that requires more than 1000 emails in every flow execution.

Configuration fields

Mail folder

Menu list with available Outlook mail folders.

Start time

Start date-time of polling. Defaults: 1970-01-01T00:00:00.000Z.

Poll only unread mail

A checkbox that, if set, only polls unread mail.

Emit behavior

The emit options are:

Emit individually

Emits each mail in a separate message.

Emit all

Emits all found emails in one message.

Actions

Check availability

This action retrieves events for the time specified in the Time field (or the current time if the Time field is empty) and returns true if no events are found or false otherwise.

Check Availability

Find next available time

This action retrieves events for the time specified in the Time field (or the current time if the Time field is empty). Returns specified time if no events are found. Otherwise, calculates the newly available time based on found event.

Find Next Available Time

Create event

The action creates an event in a specified calendar with specified options.

Create Event

Configuration fields

Calendar

Menu list with available Outlook calendars.

Time zone

Menu list with available time zones.

Importance

A menu list. The options are:

  • Low

  • Normal

  • High.

Show as

A menu list. The options are:

  • Free

  • Tentative

  • Busy

  • Out of office

  • Working elsewhere

  • Unknown

Sensitivity

A menu list. The options are:

  • Normal

  • Personal

  • Private

  • Confidential.

Body content type

A menu list. The options are:

  • Text

  • HTML

All-day event

A checkbox that, if selected, will create an all-day event.

Move mail

The action moves messages with a specified ID from the original mail folder to a specified destination mail folder. It soft-deletes messages if the destination folder is not specified.

Move Mail

Configuration fields

Original mail folder

This is a menu list with all available Outlook mail folders. The folder from which mail should be moved. This field is required.

Destination mail folder

This is a menu list with available Outlook mail folders. The folder to which mail should be moved. This field is not required. If not specified, the message will be soft-deleted (that is, moved to a folder with the deleteditems property).

Known issues and limitations

Active Directory v2.0 OAuth2

The current implementation uses the second version of the Active Directory protocol, which has some advantages.

Read the following documentation pages for more information:

lastModifiedDateTime precision issue

The lastModifiedDateTime returned by MS Graph does not include milliseconds. This is something to be aware of when using filter queries.