Microsoft Entra ID SCIM directory sync
Set up SCIM directory sync with Microsoft Entra ID
Add a provisioning configuration to your Entra enterprise application with the URL and token from this setup, assign your users and start provisioning.
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.
-
Open your enterprise application
Section titled “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”.
-
Start a provisioning configuration
Section titled “Start a provisioning configuration”Select Provisioning in the left menu, then New configuration.
-
Enter the tenant URL
Section titled “Enter the tenant URL”Paste
{scim_base_url}into Tenant URL.Paste into Microsoft Entra ID:
- SCIM base URL:
{scim_base_url}
- SCIM base URL:
-
Enter the secret token
Section titled “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.Paste into Microsoft Entra ID:
- SCIM bearer token:
{scim_token}
Fixes:
scim_token_invalid - SCIM bearer token:
-
Test the connection
Section titled “Test the connection”Select Test Connection. When it succeeds, select Create.
Fixes:
first_scim_request_pending -
Assign people and groups
Section titled “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 -
Review the attribute mappings
Section titled “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.
-
Start provisioning
Section titled “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.
Sources
Section titled “Sources”- Develop and plan provisioning for a SCIM endpoint (Microsoft Learn), read on 2026-10-11