Microsoft Outlook Connector

gb-priska · a week ago

Note on third‑party tools

We aim to provide accurate and helpful details about third‑party tools, but we can’t guarantee that this information is always complete or up to date. If you notice any discrepancies, feel free to share them in the feedback section below. For the most reliable information, please always refer to the third‑party tool’s official documentation.

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.flowbuilder.eu.lansweeper.com/callback for EU sites or https://oauth2.flowbuilder.us.lansweeper.com/callback for US sites - 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.flowbuilder.eu.lansweeper.com/callback for EU sites or https://oauth2.flowbuilder.us.lansweeper.com/callback for US sites - 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:

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.flowbuilder.eu.lansweeper.com/callback for EU sites or https://oauth2.flowbuilder.us.lansweeper.com/callback for US sites - as a Redirect URI.
3. Select Register to complete.
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.
Navigate to the Overview page save the value listed as the Application (client) ID. This will be your Client ID for the connection configuration.
Navigate to API Permissions and select Add Permission, select Microsoft Graph, and then Application permissions.
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:

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	Event ID to manipulate
Comment	Comment about the cancellation sent to all attendees

Create Calendar

Create a new Calendar

Input	Comments	Default
Connection
Name	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	Name of the Location
Subject	Subject of the Event
Body (HTML)	HTML Body of the Event
Attendees Data Collection	Field for references 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	URL to send events of this Subscription to
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

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	URL to send events of this Subscription to
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	ID of the Calendar to modify

Delete Event

Delete an Event

Input	Comments	Default
Connection
Event ID	Event ID to manipulate

Delete Mail Folder

Delete the specified mail folder

Input	Comments	Default
Connection
Folder ID

Delete Message

Delete message by ID

Input	Comments	Default
Connection
Message ID	The ID of a mail message

Delete Subscription

Delete existing subscription for Microsoft Outlook

Input	Comments	Default
Connection
Subscription ID	Subscription ID to manage

Get Calendar Event

Gets information about a specific calendar event

Input	Comments	Default
Connection
Event ID	The ID of a 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 ID of a mail 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	Enter number for desired page size.
Page Skip	Enter number of records to skip.
Fetch All	Turn on to fetch all pages of results. This will ignore the page limit and page skip inputs.	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	Enter number for desired page size.
Page Skip	Enter number of records to skip.
Fetch All	Turn on to fetch all pages of results. This will ignore the page limit and page skip inputs.	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	Enter number for desired page size.
Page Skip	Enter number of records to skip.
Fetch All	Turn on to fetch all pages of results. This will ignore the page limit and page skip inputs.	false

List Mail Messages

List mail messages in a user's mailbox

Input	Comments	Default
Connection
Folder ID	The folder to list messages for. Omit to list all messages.
Search	A search query to filter messages. Can not be used with filter.
Filter	A filter to apply to the messages. Can not be used with search.
Page Limit	Enter number for desired page size.
Page Skip	Enter number of records to skip.
Fetch All	Turn on to fetch all pages of results. This will ignore the page limit and page skip inputs.	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

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 (i.e. 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. Ex. [{"key":"my-attachment.pdf","value":""},{"key":"another-attachment.xlsx","value":""}]

Update Calendar

Update an existing Calendar

Input	Comments	Default
Connection
Calendar ID	ID of the Calendar to modify
Name	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	Event ID to manipulate
Location Name	Name of the Location
Subject	Subject of the Event
Body (HTML)	HTML Body of the Event
Attendees Data Collection	Field for references 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	Subscription ID to manage
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).