ixp
latest
false
UiPath logo, featuring letters U and I in white

Communications Mining user guide

Last updated Mar 13, 2026

Exchange Integration with Azure Application Authentication and Graph

Introduction

This step-by-step guide will show you a popular method for creating a Microsoft Exchange application for Communications Mining™ in your Azure Cloud Platform. You'll learn how to create an Application (client) with an ID and Client Secret, and find your existing Directory (tenant) ID. This will allow users to access Exchange mailbox integrations in Communications Mining.

Why is a successful integration important?

Failure to create an Exchange-Communications Mining™ application in Azure can lead to permissions errors that prevent users from accessing their mailbox integrations. To gain the full benefits of Communications Mining, follow these steps and complete the process in its entirety.

The step-by-step integration process

1. Register a new Communications Mining application

  1. Sign into your Azure portal.

  2. Go to the App Registrations menu and select New Registration.

    App registrations

  3. Fill in and configure the required fields:

    • Name: for example, uipath-exchange-integration.
    • Supported account types: select the single tenant option.
  4. Select Register, which redirects you to a page with details of the registered application, such as Application (client) ID, Directory (tenant) ID.

2. Create a client secret for a Communications Mining application

To keep your application secure, create a client secret as follows:

  1. Select Certificates and secrets under the Manage drop-down list.

  2. Select New client secret under the Client secrets tab.

    new client secret

  3. This opens the Add a client secret sidepanel.

  4. Fill in the required fields:

    • Description: enter a description for the client secret.
    • Expires: select an expiry date. The recommended option is 12 months.

    add a client secret

  5. Select Add.

  6. The client secret is displayed under the Value column.

    client secrets

Note:

Azure displays the secret value only once. Therefore, make sure you copy and store it in a safe place. If you ever lose your secret value, create a new one.

3. Set API permissions

When using the Microsoft Graph API

  1. Go to API permissions under the Manage drop-down list.

  2. Select Add a permission.

    add a permission

  3. Select Microsoft Graph under the Microsoft APIs tab.

Figure 1. The Microsoft APIs tab

The image shows the options under the Microsoft APIs tab, with a highlight on the Microsoft Graph. 4. Select Application permissions.

Figure 2. The permission options of Microsoft Graph

The image shows the permission options of Microsoft Graph highlighting the Application permissions option. 5. Expland the Mail drop-down list and select the Mail.Read permission.

Figure 3. Selecting a permission

The image shows the page for selecting a permission, highlighting the Mail.Read permission. 6. Select Add permissions. 7. Select the MailboxFolder.Read.All permission.

Figure 4. Selecting a permission

The image shows the page for selecting a permisson, highlighting the MailboxFolder.Read.All permission. 8. Select Add permissions. 9. Back in the API permissions menu, select Grant admin consent for Communications Mining. 10. Select Yes in the Grant admin consent confirmation pop-up.

![admin consent](https://dev-assets.cms.uipath.com/assets/images/ixp/ixp-admin-consent-571998-ba6851e0.webp)
![admin consent](https://dev-assets.cms.uipath.com/assets/images/ixp/ixp-admin-consent-571998-ba6851e0.webp)

4. Restrict mailbox access with a conditional access policy

At this point, you may want to limit the application permissions so that it can only access certain mailboxes within your organization. To learn how to do this, check Limiting application permissions to specific Exchange Online mailboxes in the official Microsoft documentation.

5. Create a new integration in Communications Mining

  1. Go to Communications Mining™ by accessing IXP in Automation Cloud and selecting Communication Data.

  2. Select the Integrations tab under the settings option.

  3. Select New integration.

    new integration

  4. Select an existing project, enter a name for your integration, and, optionally, a title.

  5. Select Continue.

    create new integration

  6. Fill in and configure the required fields as follows:

    • Oauth Authority: enter the previously generated tenant ID in the following format: https://login.microsoftonline.com/{tenant_id}.
    • Oauth Client Id: enter the previously generated client ID.
    • Client Secret: enter the previously generated client secret.
  7. Select the option With application access.

  8. Select Validate and save credentials to check that your credentials are valid.

  9. Select Continue.

Figure 5. The create a new integration configuration page

The image shows the create a new integration configuration page. 10. Select Add Mailbox to open the mailbox form. 11. Enter the email address for which you want to copy emails into Communications Mining™. 12. Select Add Mailbox again to save the mailbox. 13. Select Create Integration.

![add mailbox](https://dev-assets.cms.uipath.com/assets/images/ixp/ixp-add-mailbox-497079-4379283b.webp)
![add mailbox](https://dev-assets.cms.uipath.com/assets/images/ixp/ixp-add-mailbox-497079-4379283b.webp)

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated