Outlook
The Outlook component provides an integrations pathway 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.
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.
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.
Create event
The action creates an event in a specified calendar with specified options.
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.
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
deleteditemsproperty).