Overview
To authenticate with Microsoft Exchange Online Admin (Client Credentials), you need:- Tenant ID — the ID of the Microsoft Entra tenant where your app is registered.
- Client ID — the ID Microsoft Entra ID assigns to your app.
- Client Secret — a secret that lets your app call the Exchange Online Admin API without a signed-in user.
Prerequisites
- An Exchange Online subscription.
- A Microsoft Entra role that can register apps and assign roles, such as Privileged Role Administrator, and an admin who can grant tenant-wide consent.
Step 1: Register an app in Microsoft Entra ID
- Sign in to the Microsoft Entra admin center and open App registrations.

- Select New registration.

- Enter a name for your app, select Accounts in this organizational directory only, and select Register.

- On the app’s Overview page, copy the Application (client) ID and the Directory (tenant) ID. These are your Client ID and Tenant ID.

Step 2: Add the Exchange API permission
- In your app, go to API permissions > Add a permission > APIs my organization uses.
- Search for Office 365 Exchange Online and select it.
- Select Application permissions, expand Exchange, select
Exchange.ManageAsAppV2, then select Add permissions. - Select Grant admin consent for [your tenant].
Step 3: Give the app an Exchange role
The API permission lets your app get a token; an Exchange role decides what it can manage. Without one, requests return403 Forbidden.
- In the Microsoft Entra admin center, go to Roles & admins.
- Select a role that covers your integration, such as Exchange Administrator, then Add assignments, and assign it to your app.
Step 4: Create a client secret
- In your app, go to Certificates & secrets > New client secret.
- Enter a description and an expiry, then select Add.

- Copy the secret’s Value. This is your Client Secret.

Microsoft only shows the secret value once. Save it somewhere secure before leaving the page. When the secret expires, create a new one and update it in Nango.
Step 5: Enter your credentials in the Connect UI
- Open the form where you need to authenticate with Microsoft Exchange Online Admin (Client Credentials).
- Enter your Tenant ID, Client ID, and Client Secret in the designated fields.
- Submit the form, and you should be successfully authenticated.