Prerequisites

1. Roles that can perform this action:
1. Organization Owner
   
2. Organization Admin
   

1. Permission required:
1. View apps
   
2. Assign apps
   
3. Import apps
   

1. Roles that can perform this action:
   
1. Owner or App Admin role
   
2. A custom domain must be added and verified. To add and verify your domain, follow the steps in Add your custom domain name in Microsoft Entra ID.
   
3. An application must be registered in Microsoft Admin Center and configured with the required authentication settings. To complete this setup, follow the steps under Configure SAML in Microsoft 365.
   

In Zoho Directory:

Enter your verified domain name in the Domain Name field. Go to the Microsoft Entra admin center, under Entra Id, then click Overview. Copy the Tenant ID displayed in the Overview.

1. OAuth Consumer Key: Paste the Application ID that you copied from Microsoft 365.
   
2. OAuth Consumer Secret: Paste the Client Value that you copied from Microsoft 365.
   
3. Authorization Endpoint: Enter the authorization endpoint in the format: https://login.microsoftonline.com/<tenant ID>/oauth2/v2.0/authorize
4. Token Endpoint: Enter the token endpoint in the format: https://login.microsoftonline.com/<tenant ID>/oauth2/v2.0/token

By default, all Microsoft 365 fields will be mapped to a relevant Zoho Directory field. To change this mapping, you should have the Standard or Professional plans in Zoho Directory.

1. Create users: Assigning a user to Microsoft 365 in Zoho Directory automatically creates a new user account in Microsoft 365.
   
2. Update User profile: If a user account already exists in Microsoft 365 for a user, any changes made to the mapped fields in user's profile in Zoho Directory will be synced with Microsoft 365.
   
3. Delete Users: When a user is unassigned from the Microsoft 365 in Zoho Directory, the existing user's account will be deleted in Microsoft 365.
   
4. Activate and deactivate Users: Activating and deactivating users in Zoho Directory will activate or deactivate them in Microsoft 365. Additionally, users who have an account in Microsoft 365 will be activated when they are assigned to the app in Zoho Directory.
   

1. New Users: Users in Microsoft 365 who do not have an account in Zoho Directory. Users you select here will be added to Zoho Directory and, Microsoft 365 will be assigned to them.
   
2. Update Users: Users in Microsoft 365 who already exist in Zoho Directory will have their profile attributes updated based on the source profile you choose. The selected users existing details will be overwritten with the attributes from the chosen source.
   
3. Users to Activate: Microsoft 365 users who are inactive in Zoho Directory but active in Microsoft 365 will be listed here. These users will be activated in Zoho Directory and unassigned to Microsoft 365.
   
4. Users to Deactivate: Microsoft 365 users who are active in Zoho Directory but inactive in Microsoft 365 will be listed here. These users will be disabled from Microsoft 365 during import.