Skip to main content

Microsoft Outlook 365

The Unified Microsoft Outlook 365 Connector lets you connect to Microsoft Outlook 365 to access and retrieve data from your mailbox and calendar. It enables you to configure and manage email and calendar data within Designer for further processing in your workflows.

The connector uses Outlook 365 Input Tool to read emails and calendar events from Outlook 365 to Designer. The latest version is available on the Alteryx Marketplace.

Microsoft Outlook 365 Release Notes

Version 2.0.0

Version

Description

v2.0.0

  • Added Test Action support for built-in and custom OAuth authentication.

  • UI Navigation Enhancement: Starting with Designer 2026.4, all Unified Connectors support single-click selection and double-click navigation to the next configuration page.

  • Updated UI Browsing Experience: After authentication, select Mailbox, then choose Email or Calendar. The corresponding configuration options appear on the next page.

  • The Email read operation now includes options to Limit Number of Emails and Filter Emails by Date.

  • Unlike the SDK connector, which retrieves all emails by default without allowing filtering by read status, the Unified Connector lets you select which emails to retrieve.

Known Issues:

  • When you double-click a folder in My Mailbox that contains emails but no subfolders, the UI displays an incorrect informational message. This message does not prevent you from proceeding. Select Next to continue and retrieve emails from the selected folder.

Prerequisites

Before using the Unified Microsoft Outlook 365 Connector, ensure that your environment meets the following requirements:

  • Minimum Designer version: Designer 2026.4.

  • Migration from the Python-based Microsoft Outlook 365 Connector to the Unified Microsoft Outlook 365 Connector is supported in Designer 2026.4 and later.

    For more information, see Workflow Migration Utility.

Configure the Connector

The Unified Microsoft Outlook 365 Connector uses Data Connection Manager (DCM) to manage authentication and connection settings.

  1. Select an Authentication Method

    Configure authentication using either of the following methods:

    • Built-in OAuth: Use the built-in OAuth authentication method.

    • Custom OAuth: Use your custom OAuth application and configure the required authentication settings.

  2. Configure the required authentication settings in DCM. Depending on the authentication method, you can configure OAuth scopes and other connection settings. For more information, see DCM Configuration.

  3. After successful authentication, select a mailbox.

    Select Mailbox and choose Email or Calendar. Configure the available options based on your selected option.

DCM Configuration

The Unified Microsoft Outlook 365 Connector provides additional configuration options in DCM for both built-in OAuth and custom OAuth authentication.

  • OAuth Scope: You can configure the OAuth scope in DCM for both authentication methods.

    The default OAuth scope is:

    openid offline_access profile email https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.ReadWrite.Shared https://graph.microsoft.com/User.Read https://graph.microsoft.com/Calendars.ReadWrite https://graph.microsoft.com/Calendars.ReadWrite.Shared

  • Shared Mailbox: The Share Mailbox option is available on the DCM configuration page.You can configure multiple shared mailbox email addresses by separating them with commas.

    For example:

    abc@outlook.com, xyz@outlook.com, alpha@outlook.com

  • Custom OAuth Authority URL: For custom OAuth authentication, you can configure the OAuth Authority URL in DCM.

    The default URL is:

    https://login.microsoftonline.com

Version 

Description 

v1.2.2

  • Compatible with Designer and Server 2021.4.2 Patch 6, 2022.1 Patch 4 and later.

  • Compatible with AMP engine only.

  • DCM is required for running this connector in Alteryx Server.

  • Fixed issue where Outlook 365 Input overwrote emails or removed attachments of emails with same names. (TPM-4112)

  • Fixed issue where Outlook 365 Input didn’t pass metadata when there were no emails in a folder. (TPM-3407)

  • Fixed issue where Outlook 365 Input returned errors when it connected using API application with service principal. (TPM-3168)

  • Fixed issue where Outlook 365 Input removed new line separators. (TPM-3044)

  • Fixed issue where Outlook 365 Input didn’t accept UNC paths. (TPM-1298)

  • Fixed issue where Outlook 365 Input didn’t accept shared accounts. (TDCE-633)

v1.2.1

  • Compatible with Designer and Server 2021.4.2 Patch 6, 2022.1 Patch 4 and later.

  • Compatible with AMP engine only.

  • DCM is required for running this connector in Alteryx Server.

  • Fixed issue where Outlook 365 Input read only 10 folders. (TPM-3550)

  • Fixed issue where Outlook 365 Input returned a "You must enter a valid search query" error. (TPM-3406)

  • Fixed issue where Outlook 365 Input ignored proxy settings. (TPM-3357)

  • Fixed issue where Outlook 365 Input returned an error when the calendar period was set to this quarter or a leap year. (TPM-2953, TPM-2948)

  • Fixed issue where Outlook 365 Input returned a redundant text when the search query didn’t match. (TPM-2780)

  • Fixed issue where Outlook 365 Input couldn’t properly read emails in the Deleted Items folder. (TPM-2779)

  • Fixed issue where the Outlook 365 Input Help page link didn’t work. (TPM-2454)

  • Fixed issue where Outlook 365 Input couldn’t decode certificates with special characters. (TDCE-399)

v1.2.0

  • Compatible with Designer and Server 2021.4.2 Patch 6, 2022.1 Patch 4 and later.

  • Compatible with AMP engine only.

  • Added support for DCM.

    • DCM is required for running this connector on Alteryx Server.

  • FIPS capable.

  • Added new calendar intervals.

  • Fixed issue where Outlook 365 Input failed to read emails with .msg attachments. (TPM-2151)

  • Fixed issue where search didn’t work for certain query parameters. (TPM-523)

  • Minor bugfixes and improvements.

v1.1.0

  • Authentication occurs using user's browser instead of embedded CEF in Designer to comply with modern security policies.

  • Compatible with Designer version 2021.4 and later.

Enable AMP Engine

Make sure you have the AMP engine enabled for the workflows that contain Outlook Input to leverage the full potential of Designer capabilities.

Custom Microsoft Azure API Application Setup

To set up a custom API application for this tool, go to our guide.