Microsoft Outlook Connector

Read and manage Microsoft Outlook calendars and email

Connections

OAuth 2.0 Authorization Code

Authenticates actions in all Microsoft's Graph API services.

You will first need to create and configure a new "App Registration" within your Azure Active Directory tenant. When creating the application you will be prompted to select the 'Supported account types'. Under this section, be sure to select 'Accounts in any organizational directory (Any Azure AD directory - Multitenant)'.

You will need to go to "Platforms" and add the "Web" platform. In that section you should add the OAuth 2.0 callback URL - https://oauth2.integrations.acme.com/callback - as a Redirect URI.

Next, go to "Certificates & Secrets" for the app and add a new Client Secret. Note this value as you will need to supply it to the connection.

You will also need the Application (client) ID from the "Overview" page.

Now, configure the OAuth 2.0 connection. Add an Microsoft Outlook OAuth 2.0 connection config variable:

• Use the Application (client) ID value for the Client ID field.
• Use the Client Secret for the same named field.
• If you didn't select Multitenant when creating the Azure application, you will need to replace the Authorize URL and Token URL with ones specific to your tenant.
• The default scopes are as follows. You can remove scopes that you don't need:
  • https://graph.microsoft.com/User.Read for reading basic user data
  • https://graph.microsoft.com/Calendars.ReadWrite for managing Outlook calendar
  • https://graph.microsoft.com/Mail.ReadWrite for managing email
  • https://graph.microsoft.com/Mail.Send for sending email

Save your integration and you should be able to authenticate a user with OAuth 2.0 to access their Microsoft Outlook data.

This connection uses OAuth 2.0, a common authentication mechanism for integrations. Read about how OAuth 2.0 works here.

Input	Comments	Default
Base URL	The base URL for the Microsoft Graph API. Depending on your cloud environment, you can choose the correct one here.	https://graph.microsoft.com
Tenant URL	The tenant URL for the Microsoft Graph API. This is the URL of the tenant that you are connecting to. You can find this in the Azure portal or here.	login.microsoftonline.com/common
Scopes	Microsoft Graph API permission scopes are set on the OAuth application.	https://graph.microsoft.com/User.Read https://graph.microsoft.com/Calendars.ReadWrite https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send offline_access
Client ID	Client Id of your Azure application.
Client secret value	Client Secret generated under 'Certificates & Secrets' in your Azure application.

OAuth 2.0 Authorization Code (Deprecated)

OAuth 2.0 Authorization Code Connectivity for Microsoft Outlook

You will first need to create and configure a new "App Registration" within your Azure Active Directory tenant. When creating the application you will be prompted to select the 'Supported account types'. Under this section, be sure to select 'Accounts in any organizational directory (Any Azure AD directory - Multitenant)'.

You will need to go to "Platforms" and add the "Web" platform. In that section you should add the OAuth 2.0 callback URL - https://oauth2.integrations.acme.com/callback - as a Redirect URI.

Next, go to "Certificates & Secrets" for the app and add a new Client Secret. Note this value as you will need to supply it to the connection.

You will also need the Application (client) ID from the "Overview" page.

Now, configure the OAuth 2.0 connection. Add an Microsoft Outlook OAuth 2.0 connection config variable:

• Use the Application (client) ID value for the Client ID field.
• Use the Client Secret for the same named field.
• If you didn't select Multitenant when creating the Azure application, you will need to replace the Authorize URL and Token URL with ones specific to your tenant.
• The default scopes are as follows. You can remove scopes that you don't need:
  • https://graph.microsoft.com/User.Read for reading basic user data
  • https://graph.microsoft.com/Calendars.ReadWrite for managing Outlook calendar
  • https://graph.microsoft.com/Mail.ReadWrite for managing email
  • https://graph.microsoft.com/Mail.Send for sending email
  • Ensure the offline_access scope is included in your app registration. It is essential to maintain your OAuth connection and receive refresh tokens. Without it, users will need to re-authenticate every hour.

Save your integration and you should be able to authenticate a user with OAuth 2.0 to access their Microsoft Outlook data.

This connection uses OAuth 2.0, a common authentication mechanism for integrations. Read about how OAuth 2.0 works here.

Input	Comments	Default
Base URL	The base URL for the Microsoft Graph API. Depending on your cloud environment, you can choose the correct one on this page.	https://graph.microsoft.com
Authorize URL	The OAuth 2.0 Authorization URL for Microsoft Outlook	https://login.microsoftonline.com/common/oauth2/v2.0/authorize?prompt=consent
Token URL	The OAuth 2.0 Token URL for Microsoft Outlook	https://login.microsoftonline.com/common/oauth2/v2.0/token
Scopes	Microsoft Outlook permission scopes are set on the OAuth application	https://graph.microsoft.com/User.Read https://graph.microsoft.com/Calendars.ReadWrite https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send offline_access
Client ID
Client secret value

OAuth 2.0 Client Credentials

Authenticates actions in all Microsoft's Graph API services.

This Connection will require an App Registration:

1. Navigate to the Microsoft Entra Identity > Applications > App registrations and select New registration.
   1. Set the Supported Account types to Accounts in any organizational directory (Any Azure AD directory - Multitenant) so that users outside of your organization (i.e. your customers) can authenticate.
   2. Set the Redirect URI dropdown as a "Web" platform. In that section add the OAuth callback URL https://oauth2.integrations.acme.com/callback - as a Redirect URI.
   3. Select Register to complete.
2. From the App menu navigate to Certificates & Secrets for the app and add a new Client Secret. Save the Value for the Client Secret in the connection's configuration.
3. Navigate to the Overview page save the value listed as the Application (client) ID. This will be your Client ID for the connection configuration.
4. Navigate to API Permissions and select Add Permission, select Microsoft Graph, and then Application permissions.
5. After applying all permissions relevant for your use-case, click on Grant Admin Consent in order to transfer permissions the client credentials flow after a successful connection.

To configure the OAuth 2.0 connection:

1. Add an OAuth 2.0 connection configuration variable:
   1. All actions for the client credentials flow require authentication with your Tenant ID.
   2. Use the Application (client) ID value for the Client ID field.
   3. Use the Client Secret for the same named field.
   4. Use the default scope that comes set up with the connection.

This connection uses OAuth 2.0, a common authentication mechanism for integrations. Read about how OAuth 2.0 works here.

Input	Comments	Default
Base URL	The base URL for the Microsoft Graph API. Depending on your cloud environment, you can choose the correct one here.	https://graph.microsoft.com
Microsoft Entra ID Endpoint	The Microsoft Entra ID endpoint for the Microsoft Graph API. You can find this in the Azure portal or here.	https://login.microsoftonline.com
Tenant	The tenant ID or name for the Microsoft Graph API. This is the ID or name of the tenant that you are connecting to.
Client ID	Client Id of your Azure application.
Client Secret	Client Secret generated under 'Certificates & Secrets' in your Azure application.
Scopes	Microsoft Graph API Scopes.	https://graph.microsoft.com/.default
User ID	User ID to specify which user's data to access. Required for client credentials authentication to work with user-specific endpoints.

Triggers

Webhook

Receive and validate webhook requests from Outlook for webhooks you configure.

Actions

Cancel Event

Cancel an Event

Input	Comments	Default
Connection
Event ID	The unique identifier of the event.
Comment	Comment about the cancellation sent to all attendees

Create Calendar

Create a new Calendar

Input	Comments	Default
Connection
Name	The name of the calendar.
Color	Color of the calendar; see 'color' at https://learn.microsoft.com/en-us/graph/api/resources/calendar?view=graph-rest-1.0#properties for details	auto

Create Event

Create an Event on a Calendar

Input	Comments	Default
Connection
Calendar ID	Calendar ID to list events of. Will list all events for current user if unspecified.
Location Name	The name of the location.
Subject	The subject of the event.
Body (HTML)	The HTML body of the event.
Attendees Data Collection	Reference to data structures representing attendees. Will be merged with Attendees if both are specified.
Type	Attendees of the event.
Start At	ISO formatted timestamp without timezone information.
Start Timezone	Timezone for the start time of the event. Use the List Supported Timezones action for details on valid aliases/values for this user.	UTC
End At	ISO formatted timestamp without timezone information.
End Timezone	Timezone for the end time of the event. Use the List Supported Timezones action for details on valid aliases/values for this user.	UTC

Create Event Subscription

Create an Event subscription for Microsoft Outlook

Input	Comments	Default
Connection
Notification URL	The URL where notification events will be sent.
Expiration Date/Time	Expiration date/time for subscription. If unspecified, the default will be the current date/time plus 10070 minutes (close to the maximum permitted by the Graph API).
Allow Duplicates	Enable to allow more than one webhook per endpoint.	false

Create Mail Folder

Create a new mail folder

Input	Comments	Default
Connection
Parent Folder ID	Create a folder under this parent folder. Omit to create a root-level folder.
Display name	The display name of the folder.

Create Mail Folder Subscription

Create a Mail Folder subscription for Microsoft Outlook

Input	Comments	Default
Connection
Mail Change Types	The type of change to listen for.
Notification URL	The URL where notification events will be sent.
Expiration Date/Time	Expiration date/time for subscription. If unspecified, the default will be the current date/time plus 10070 minutes (close to the maximum permitted by the Graph API).

Delete All Instance Subscriptions

Delete all subscriptions pointed at this instance

Input	Comments	Default
Connection

Delete Calendar

Delete an existing Calendar

Input	Comments	Default
Connection
Calendar ID	The unique identifier of the calendar to modify.

Delete Event

Delete an Event

Input	Comments	Default
Connection
Event ID	The unique identifier of the event.

Delete Mail Folder

Delete the specified mail folder

Input	Comments	Default
Connection
Folder ID	The unique identifier of the folder.

Delete Message

Delete message by ID

Input	Comments	Default
Connection
Message ID	The unique identifier of the message.

Delete Subscription

Delete existing subscription for Microsoft Outlook

Input	Comments	Default
Connection
Subscription ID	The unique identifier of the subscription.

Get Calendar Event

Gets information about a specific calendar event

Input	Comments	Default
Connection
Event ID	The unique identifier of the calendar event.

Get Current User

Get the information and metadata of the user that is currently logged in

Input	Comments	Default
Connection

Get Mail Message

Fetch and parse a raw message by ID

Input	Comments	Default
Connection
Message ID	The unique identifier of the message.

Get Schedule Availability

Get the free/busy availability information for a collection of users

Input	Comments	Default
Connection
Availability View Interval	Duration of time slot to check availability for in minutes	30
Schedules	Collection of SMTP addresses of users, distribution lists, or resources to get availability information for
Start At	ISO formatted timestamp without timezone information.
Start Timezone	Timezone for the start time of the event. Use the List Supported Timezones action for details on valid aliases/values for this user.	UTC
End At	ISO formatted timestamp without timezone information.
End Timezone	Timezone for the end time of the event. Use the List Supported Timezones action for details on valid aliases/values for this user.	UTC

List Calendars

List all Calendars for the user

Input	Comments	Default
Connection
Page Limit	The maximum number of results to return per page.
Page Skip	The number of records to skip before returning results.
Fetch All	Fetch all records using pagination.	false

List Events

List all Events for the user

Input	Comments	Default
Connection
Calendar ID	Calendar ID to list events of. Will list all events for current user if unspecified.
Page Limit	The maximum number of results to return per page.
Page Skip	The number of records to skip before returning results.
Fetch All	Fetch all records using pagination.	false

List Mail Folders

Get the mail folder collection directly under the root folder of the signed-in user, or under the specified parent folder.

Input	Comments	Default
Connection
Parent Folder ID	List all folders contained within this folder. Omit to list root-level folders.
Page Limit	The maximum number of results to return per page.
Page Skip	The number of records to skip before returning results.
Fetch All	Fetch all records using pagination.	false

List Mail Messages

List mail messages in a user's mailbox

Input	Comments	Default
Connection
Folder ID	The unique identifier of the folder. Omit to list all messages.
Search	A search query to filter messages. Cannot be used with Filter.
Filter	A filter to apply to the messages. Cannot be used with Search.
Page Limit	The maximum number of results to return per page.
Page Skip	The number of records to skip before returning results.
Fetch All	Fetch all records using pagination.	false

List Subscriptions

List all subscriptions for Microsoft Outlook

Input	Comments	Default
Connection
Show Instance Webhooks	Show only subscriptions for this instance's webhooks.	true
Fetch All	Turn on to fetch all pages of results.	true

List Supported Languages

List supported languages for current user

Input	Comments	Default
Connection

List Supported Timezones

List supported timezones for current user

Input	Comments	Default
Connection

Raw Request

Send raw HTTP request to Microsoft Outlook

Input	Comments	Default
Connection
URL	Input the path only (/me/calendars), The base URL is already included (https://graph.microsoft.com/v1.0). For example, to connect to https://graph.microsoft.com/v1.0/me/calendars, only /me/calendars is entered in this field.
Method	The HTTP method to use.
Data	The HTTP body payload to send to the URL.
Form Data	The Form Data to be sent as a multipart form upload.
File Data	File Data to be sent as a multipart form upload.
File Data File Names	File names to apply to the file data inputs. Keys must match the file data keys above.
Query Parameter	A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.
Header	A list of headers to send with the request.
Response Type	The type of data you expect in the response. You can request json, text, or binary data.	json
Timeout	The maximum time that a client will await a response to its request
Retry Delay (ms)	The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.	0
Retry On All Errors	If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors.	false
Max Retry Count	The maximum number of retries to attempt. Specify 0 for no retries.	0
Use Exponential Backoff	Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.	false

Send Message

Send a new message

Input	Comments	Default
Connection
To	You can specify multiple addresses separated by commas. i.e. 'john@example.com' or 'john@example.com,sally@example.com'
CC	You can specify multiple addresses separated by commas. i.e. 'john@example.com' or 'john@example.com,sally@example.com'
BCC	You can specify multiple addresses separated by commas. i.e. 'john@example.com' or 'john@example.com,sally@example.com'
Subject
Message Body	Plain text or HTML body
Body Content Type		html
Attachments	Specify a file name as the key (e.g., my-file.pdf) and the file as the value.
Dynamic Attachments	An array of objects with "key" and "value" properties, where "key" is the file name and "value" is the binary file data. Typically used as a reference from a previous step.

Update Calendar

Update an existing Calendar

Input	Comments	Default
Connection
Calendar ID	The unique identifier of the calendar to modify.
Name	The name of the calendar.
Color	Color of the calendar; see 'color' at https://learn.microsoft.com/en-us/graph/api/resources/calendar?view=graph-rest-1.0#properties for details	auto

Update Event

Update an existing Event

Input	Comments	Default
Connection
Event ID	The unique identifier of the event.
Location Name	The name of the location.
Subject	The subject of the event.
Body (HTML)	The HTML body of the event.
Attendees Data Collection	Reference to data structures representing attendees. Will be merged with Attendees if both are specified.
Type	Attendees of the event.
Start At	ISO formatted timestamp without timezone information.
Start Timezone	Timezone for the start time of the event. Use the List Supported Timezones action for details on valid aliases/values for this user.	UTC
End At	ISO formatted timestamp without timezone information.
End Timezone	Timezone for the end time of the event. Use the List Supported Timezones action for details on valid aliases/values for this user.	UTC

Update Event Subscription Expiration

Update existing Event subscription expiration for Microsoft Outlook

Input	Comments	Default
Connection
Subscription ID	The unique identifier of the subscription.
Expiration Date/Time	Expiration date/time for subscription. If unspecified, the default will be the current date/time plus 10070 minutes (close to the maximum permitted by the Graph API).