# Microsoft Entra ID SCIM directory sync

<!-- Generated by scripts/generate.ts. Do not edit. -->

Add a provisioning configuration to your Entra enterprise application with the URL and token from this setup, assign your users and start provisioning.

:::caution[Verification]
Not yet verified on a real Microsoft Entra ID tenant. It was written from the public Microsoft Entra ID documentation, so labels in the admin console may differ slightly.
:::

The values in braces, such as `{scim_base_url}`, are specific to your connection. The setup link from the application you are connecting shows them with a copy button. The same steps appear there.

## Steps

<ol class="idp-steps">

<li class="idp-step">

<a id="app"></a>

### Open your enterprise application

In the Microsoft Entra admin center, browse to Entra ID > Enterprise apps and open the application you use for single sign-on. If you have none, select New application > Create your own application and choose "Integrate any other application you don't find in the gallery".

</li>

<li class="idp-step">

<a id="new-configuration"></a>

### Start a provisioning configuration

Select Provisioning in the left menu, then New configuration.

</li>

<li class="idp-step">

<a id="tenant-url"></a>

### Enter the tenant URL

Paste `{scim_base_url}` into Tenant URL.

<div class="setup-values">

Paste into Microsoft Entra ID:

- SCIM base URL: `{scim_base_url}`

</div>

</li>

<li class="idp-step">

<a id="token"></a>

### Enter the secret token

Paste `{scim_token}` into Secret Token. The token is shown once in this setup; generate a new one here if you lose it.

<div class="setup-values">

Paste into Microsoft Entra ID:

- SCIM bearer token: `{scim_token}`

</div>

Fixes: [`scim_token_invalid`](/errors/scim_token_invalid/)

</li>

<li class="idp-step">

<a id="test"></a>

### Test the connection

Select Test Connection. When it succeeds, select Create.

Fixes: [`first_scim_request_pending`](/errors/first_scim_request_pending/)

</li>

<li class="idp-step">

<a id="assign"></a>

### Assign people and groups

On Users and groups, assign the people and groups to sync. With the scope Sync only assigned users and groups, nothing is sent until you do.

Fixes: [`scim_user_out_of_domain`](/errors/scim_user_out_of_domain/)

</li>

<li class="idp-step">

<a id="mappings"></a>

### Review the attribute mappings

Select Attribute mapping and review the user and group mappings. Keep userName mapped to the user principal name or email address, and select Save if you change anything.

</li>

<li class="idp-step">

<a id="start"></a>

### Start provisioning

Optionally try Provision on-demand with one user. Then open Overview and select Start provisioning. Entra sends changes on its regular cycle, about every 40 minutes.

</li>

</ol>

## Sources

- [Develop and plan provisioning for a SCIM endpoint (Microsoft Learn)](https://learn.microsoft.com/en-us/entra/identity/app-provisioning/use-scim-to-provision-users-and-groups), read on 2026-10-11
