> ## Documentation Index
> Fetch the complete documentation index at: https://nango-marcin-get-deployments-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Intune - How do I link my account?

# Overview

To connect Microsoft Intune in Nango, you need to provide:

1. **Tenant ID** — The unique identifier for your organization that uses Microsoft services.
2. **Client ID** — The unique identifier that Azure assigns to your application when it's registered.
3. **Client Secret** — A unique string that enables the client application to access Microsoft Intune.

This guide will walk you through generating and finding these credentials within Azure.

### Prerequisites

* You must have an active Azure account with a Microsoft Intune subscription.
* You must have permission to register applications and grant admin consent in Microsoft Entra ID.

### Step 1: Finding your Tenant ID

1. Your Tenant ID can be found in the **Tenant ID** field on the [Overview page](https://aad.portal.azure.com/#view/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/~/Overview) within your Azure account.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/DVrtJn_EDMUDVpWS/integrations/all/microsoft-business-central/tenant_id.png?fit=max&auto=format&n=DVrtJn_EDMUDVpWS&q=85&s=b3bdcba97aa7f22289d8418b54d0f60d" width="3024" height="984" data-path="integrations/all/microsoft-business-central/tenant_id.png" />

### Step 2: Generating your Client ID

1. Navigate to the [Azure portal home page](https://portal.azure.com/#home) and sign in using the credentials of an administrator.
2. Select **App registrations**.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/DVrtJn_EDMUDVpWS/integrations/all/microsoft-business-central/app_registration.png?fit=max&auto=format&n=DVrtJn_EDMUDVpWS&q=85&s=d8144bf0d4cfb15dcb3af69554d0857c" width="3024" height="1372" data-path="integrations/all/microsoft-business-central/app_registration.png" />

3. Select **New registration**.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/DVrtJn_EDMUDVpWS/integrations/all/microsoft-business-central/new_registration.png?fit=max&auto=format&n=DVrtJn_EDMUDVpWS&q=85&s=85ee595a619cf5fcb9907b5416753ae9" width="3024" height="1372" data-path="integrations/all/microsoft-business-central/new_registration.png" />

4. In the **Register an application** section, enter a meaningful application name to display to users (e.g. `Nango Intune`). Under **Supported account types**, leave it to the default one which is **Single tenant Only** and click **Register**.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/pMmrQEHxzzVBg1I3/api-integrations/microsoft-intune/create_application.png?fit=max&auto=format&n=pMmrQEHxzzVBg1I3&q=85&s=e13f4dff10933d9238c0b6406406fc74" width="1918" height="723" data-path="api-integrations/microsoft-intune/create_application.png" />

5. Once you have registered your application, your **Client ID** will be displayed in the **Application (client) ID** field within the **Essentials**. Your **Tenant ID** is shown in the **Directory (tenant) ID** field.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/pMmrQEHxzzVBg1I3/api-integrations/microsoft-intune/client_id.png?fit=max&auto=format&n=pMmrQEHxzzVBg1I3&q=85&s=68e712e674b077f97c71e74f316a29ee" width="1918" height="723" data-path="api-integrations/microsoft-intune/client_id.png" />

### Step 3: Generating your Client Secret

1. After registering a new app in the [step above](#step-2-generating-your-client-id), navigate to **Certificates & secrets** under **Manage**, and click **New client secret**.
2. A pop-up modal will appear, prompting you to enter your secret's **Description** and **Expires** values. Fill these then click on **Add**.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/pMmrQEHxzzVBg1I3/api-integrations/microsoft-intune/client_secret.png?fit=max&auto=format&n=pMmrQEHxzzVBg1I3&q=85&s=3b38d22d68c5e9ca3f33eff5fc6e15be" width="1918" height="776" data-path="api-integrations/microsoft-intune/client_secret.png" />

3. Once completed, your **Client Secret** will be generated. This value can be found in the **Value** field within the **Client Secrets** table.
4. After generating the **Client Secret**, you must grant the registered application the necessary permissions. Navigate to **API permissions**, select **Add a permission**, and choose **Microsoft Graph**.
5. From the displayed list, choose **Application permissions**, select the required Intune permissions, and click **Add permissions**. Common permissions include:
   * `DeviceManagementManagedDevices.Read.All` — read managed devices
   * `DeviceManagementManagedDevices.ReadWrite.All` — read and write managed devices
   * `DeviceManagementConfiguration.Read.All` — read device configuration policies
   * `DeviceManagementApps.Read.All` — read mobile app management data

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/pMmrQEHxzzVBg1I3/api-integrations/microsoft-intune/permissions.png?fit=max&auto=format&n=pMmrQEHxzzVBg1I3&q=85&s=0dc5da6e733aef0340277cf2344e2cef" width="1918" height="776" data-path="api-integrations/microsoft-intune/permissions.png" />

6. Select **Grant admin consent for \[your organization]** and confirm. Admin consent is required for application permissions.

<Note>
  The Intune service must be correctly licensed on the tenant for these API calls to succeed, regardless of whether the permissions are granted.
</Note>

### Step 4: Enter credentials in the Connect UI

Once you have your credentials:

1. Open the form where you need to authenticate with Microsoft Intune.
2. Enter the **Tenant ID**, **Client ID**, and **Client Secret** in their designated fields.
3. Submit the form, and you should be successfully authenticated.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/pMmrQEHxzzVBg1I3/api-integrations/microsoft-intune/form.png?fit=max&auto=format&n=pMmrQEHxzzVBg1I3&q=85&s=935dd65890fc9125cf53e7d60ac91891" style={{maxWidth: "450px" }} width="502" height="698" data-path="api-integrations/microsoft-intune/form.png" />

You are now connected to Microsoft Intune.
