Skip to content
Dashboard
Theme
Theme

Microsoft Entra ID SCIM directory sync

Set up SCIM directory sync with Microsoft Entra ID

View Markdown

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.

  1. 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”.

  2. Select Provisioning in the left menu, then New configuration.

  3. Paste {scim_base_url} into Tenant URL.

    Paste into Microsoft Entra ID:

    • SCIM base URL: {scim_base_url}
  4. 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

  5. Select Test Connection. When it succeeds, select Create.

    Fixes: first_scim_request_pending

  6. 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

  7. 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.

  8. 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.