---
schema_version: "1"
id: 067a81c32f091b828c6712156dd59d4e24ace23841136f8b4466296cf923b02e
title: Troubleshooting Microsoft Azure Setup
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/rpa-builder/latest/troubleshooting-azure-oauth-setup.md
canonical_url: https://docs.mulesoft.com/rpa-builder/latest/troubleshooting-azure-oauth-setup
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 4b4a377b04d24215162e9422b8cbcc449901a46b5de7f1a9ec0ebf31609eca24
description: MuleSoft Documentation Site
release: "6.7"
latest: true
---
---
product: RPA Builder
version: 6.7
is-latest-version: true
---

# Troubleshooting Microsoft Azure Setup

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

If you have issues configuring your Azure account with Mail Session (Outlook with OAuth), follow
these troubleshooting steps to ensure your app is properly registered and configured:

1.  [Register an App in Azure](#register-app)

2.  [Create a Client Secret for the App](#create-secret)

3.  [Verify the Settings](#verify-settings)

4.  [Add Permissions to the App](#add-permissions)

## Register an App in Azure

1.  Navigate to [https://portal.azure.com/](https://portal.azure.com/) and log in with your Azure
    account.

2.  Open the **App Registrations** page and create a new registration.

    - Select the supported account types.

    - Provide a Redirect URI.

      For the configuration to work, you must specify a valid redirect URL, for example:
      `http://localhost:49453/`.

For additional instructions about registering apps in Azure, see
[Azure: Register a web application](https://learn.microsoft.com/en-us/azure/active-directory-b2c/tutorial-register-applications#register-a-web-application).

## Create a Client Secret for the App

After registering an app in Azure, the app’s setting page opens.

1.  Open the **Certificates & Secrets** page.

2.  Create a new client secret.

    > [!WARNING] After creating the secret, ensure you copy its **Value** as this is the only time
    > you can see it. After you leave this page, the secret is no longer accessible.

For additional instructions about creating client secrets, see
[Azure: Create a client secret](https://learn.microsoft.com/en-us/azure/active-directory-b2c/tutorial-register-applications#create-a-client-secret).

In some cases, authentication might not work if you have more than one secret defined or use the 24
month expiration cycle. When your authentication in RPA Builder doesn’t work, try deleting all
client secrets in your Azure app and adding a new client secret with an expiration cycle of 6
months.

## Verify the Settings

After registering the app and creating a client secret, open the app’s **Overview** page and ensure
you have:

- One secret under **Client Credentials**

- One **Redirect URI**

If you created a Single-tenant app, locate the tenant ID for further use in the Mail Session
(Outlook with OAuth) configuration.

Depending on the account type you selected when registering your app (Single or Multi tenant), the
**OAuth Host** you configure in Mail Session (Outlook with OAuth) changes:

- Multitenant: Specify `https://login.microsoftonline.com/common/oauth2/v2.0/` as the **OAuth Host**
  URL.

- Single tenant: Specify `https://login.microsoftonline.com/{{YOUR_TENANT_ID}}/oauth2/v2.0/` as the
  **OAuth Host** URL.

## Add Permissions to the App

After registering your app and creating its client secret, configure permission settings:

1.  Open **API Permissions** in the side bar.

2.  Click **Add a Permission** and select **Microsoft Graph**.

3.  Select **Delegated Permissions** and add the following permissions from the **OpenId
    permissions** category:

    - `email`

    - `offline_access`

    - `openid`

    - `profile`

4.  Select the appropriate permissions and protocols depending on your workflow needs:

    - Category `Mail`

    - Category `IMAP`

    - Category `EWS`

    - Category `POP`

    - Category `SMTP`

    If you don’t know the permissions and protocols that apply to your case, select all of them.

## See Also

- [Mail Session (OAuth)](https://docs.mulesoft.com/rpa-builder/latest/toolbox-mail-operations-mail-session-oauth)

- [Azure Tutorial: Register a web application in Azure Active Directory B2C](https://learn.microsoft.com/en-us/azure/active-directory-b2c/tutorial-register-applications)

- [Known Issues](https://help.salesforce.com/s/issues)