Zoho One Sync Tool - Troubleshooting
This document contains error messages you may encounter when you're setting up and using the Zoho One Sync Tool, and the methods to resolve those errors.
Some of the solutions will require you to check the Sync Tool's logs, which can usually be found at C:\Program Files (x86)\ZOHOCORP\ZohoOneSync\logs.
The error messages are listed based on the screen they appear in.
Zoho Sign-in screen
These errors will be shown if the Sync Tool was unable to sign you in to your Zoho One admin account.
Error | Reason | Solution |
Authorization failed | You are not a Zoho One administrator. | Ask a Zoho One administrator to sign in to the tool. |
InvalidClient / InvalidAuthScope | There has been some mismatch in the configuration of the tool. | Please contact support@zohoone.com to obtain the correct configuration. |
Only one instance of the tool can be used for an organization. Please contact support. | ||
General Error | The operation failed due to some unexpected problem. | Please contact support@zohoone.com for help. |
LDAP Configuration screen
These errors will be shown if the sync tool was unable to access your Active Directory (AD)/LDAP server using the credentials you provided.
Error | Reason | Solution |
General Error | You do not have enough permissions in AD to perform a sync. | Ask your admin to provide you READ and REPLICATING DIRECTORY CHANGES permissions in AD for the domains that need to be synced. |
Attributes screen
This error will be shown if the Sync Tool had trouble mapping Zoho One's fields with Active Directory (AD) attributes.
Error | Reason | Solution |
Custom field is deleted in Server. Delete? | The custom field was deleted in Zoho One, and can no longer be synced. | Delete the mapping, or add the custom field again in the Zoho One admin panel. |
Directory Sync and Reports screen
These errors will be shown in the Status column of the Directory Sync - Users, Directory Sync - Groups, and the Reports screens, if the tool was unable to sync a user or a group.
Error | Reason | Solution |
Invalid Email Address | The user does not have an email address in Active Directory (AD). | Add an email address for the user and try again. |
Bad Request | One of the mapped attributes has a value with incorrect formatting. | Please contact support@zohoone.com for help. |
Request Failed / Server Error | The server might not be reachable from your system, or a data mismatch might have occurred. | Please contact support@zohoone.com for help. |
Multiple Emails exists. | At least one of the user's email addresses belongs to a different Zoho One organization. | Ask the user to delete their existing Zoho account, or contact support@zohoone.com for help. |
Already Exists | The user or group has already been created in Zoho. | No rectification needed. From the next sync, the user/group will get updated. |
DomainControllers are not operational | You domain controller is not reachable from your system. | Check the status of your DC. If the problem persists, contact support@zohoone.com. |
Data Access Error | The Sync Tool is unable to access your Zoho One organization. | Sign in to the Sync Tool again using the Reassign ownership button in the Zoho Sign-in screen, then try syncing again. If the problem persists, contact support@zohoone.com with your Sync Tool's log files. |
Domain not verified | The email domain is not verified in Zoho One. | Verify the domain and try again. |
Operation not supported | You have no more free Zoho One licenses left. | Purchase more Zoho One licenses and try again. |
Mandatory attribute missing | A custom field marked as mandatory in Zoho One is not available in Active Directory (AD). | Check the AD attribute mapped with the mandatory custom field, ensure the attribute has some value, then try again. |
Attribute length exceeded | An attribute's value is longer than the maximum length supported by the Zoho One field mapped to it. | Check the logs to find the attribute, ensure its value is within the accepted length, then try again. |
Invalid attribute value | An attribute's value has characters not accepted in the Zoho One field mapped to it. | Check the attribute's value for any inappropriate characters (e.g., alphabets in the "Phone" field), then try again. |
Exists in another deployment | The user already has a Zoho account in another Data Center (DC). | Request the user to close the other account, then try again. |
Password Sync screen
This error may be shown when you're trying to install the Password Sync Agent in your domain controllers.
Error | Reason | Solution |
Agent can't be installed | A prerequisite for the password sync agent has not been met. | Go through the prerequisites for installing the password sync agent and ensure they've been met in all the required domain controllers. |
Related Articles
Zoho One Sync Tool - Overview
Zoho One Sync Tool performs a one-way synchronization from your existing LDAP server to the Zoho One Admin Panel. This enables you to maintain all your user identities in a single place, without having to add, edit, or disable user accounts manually ...Sync from Active Directory/LDAP server
Note: Before you install the Zoho One sync tool, ensure that you meet the system requirements. Sign in to Zoho One , then click Directory in the left menu. Go to Active Directory, then click Download. Install the downloaded file in the Domain ...Zoho One Sync Tool - System requirements
Zoho One Sync Tool READ and REPLICATING DIRECTORY CHANGES permissions for the domains that need to be synced .NET Framework - 4.6 or later Browser - Internet Explorer 9 or later Operating System - Windows 7 or later Password Sync Agent ...Reset tool
Prerequisite: The Sync Tool must have been installed and run at least once. Open the Sync Tool. Go to Settings. Click Reset Zoho One Sync Tool, then Delete. Note: Only the settings configured in the tool will be deleted. Users and groups that have ...Sync passwords
Prerequisite: The Sync Tool must have been installed and run at least once. Open the Sync Tool. Go to Password Sync, then click Install Agent. Choose the domain controllers the agent needs to be installed in. Check Restart selected DCs after ...