Resolve Microsoft Entra ID SCIM user account conflicts in Apple School Manager
When you first use Microsoft Entra ID SCIM to import users into Apple School Manager, Auto Merge should be disabled and all user account conflicts should be resolved manually.
Important: If Auto Merge is turned on, new accounts are merged with existing accounts in Apple School Manager.
If you disconnect from Microsoft Entra ID and reconnect, you can choose whether to merge the Entra ID accounts and the existing Apple School Manager accounts previously imported using a data source (such as SFTP). After you reconnect, check the Entra ID provisioning logs. After all the accounts are synced to Apple School Manager, you can choose to disable Auto Merge to avoid any account merge issues.
Disable Auto Merge
If you want a conflicting account to be connected to SCIM, start by manually resolving the conflict by disabling Auto Merge.
In Apple School Manager , sign in with a user that has the role of Administrator, Site Manager, or People Manager.
Select your name at the bottom of the sidebar, select Preferences , then select Directory Sync .
Turn off Auto Merge.
Manually resolve Microsoft Entra ID user account conflicts
If you want a conflicting account to be connected using SCIM, you can manually resolve the conflict.
In Apple School Manager , sign in with a user that has the role of Administrator, Site Manager, or People Manager.
Select your name at the bottom of the sidebar, select Preferences , then select Directory Sync .
Select Edit next to the SCIM section, carefully read the Account Conflict message, then select Resolve.
Select the Download Conflicts button to download a list of account conflicts, then review the conflicts.
If the conflicting accounts are identical to each other in Microsoft Entra ID and Apple School Manager, select Merge.
How conflicts can occur
Conflicts can occur in one of the following ways:
An account user name conflicts with an existing Managed Apple ID for a user account imported from SFTP or from SIS
The SCIM connection was disconnected and connected back again, and an Apple School Manager account was imported using SCIM.
An Apple School Manager user account has a Person ID value and a Managed Apple ID that matches a Microsoft Entra ID user name you’re attempting to import using SCIM.
The option Sync Only Assigned Users and Groups is enabled, and the following actions occur in order.
1. A user is removed from the Apple School Manager Entra ID app.
2. The user is then deleted from Microsoft Entra ID.
3. A new user is created in Microsoft Entra ID with the same user name.
4. That new user is added to the Apple School Manager Entra ID app.