Zoho Directory Sync Tool - Troubleshooting
Prerequisites
Roles required to perform this action:
- Organization Owner
- Organization Admin
Troubleshooting
This document contains error messages you may encounter when you're
setting up and using the Zoho Directory 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\ZohoDirectorySync\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 Directory admin account.
Error | Reason | Solution |
Authorization failed | You are not a Zoho Directory administrator. | Ask a Zoho Directory administrator to sign in to the tool. |
InvalidClient / InvalidAuthScope | There has been some mismatch in the configuration of the tool. | Please contact support@zohodirectory.com to obtain the correct configuration. |
Only one instance of the tool can be used for an organization. Please contact support. | Delete the previously installed instance, or contact support@zohodirectory.com to add a second instance. | |
General Error | The operation failed due to some unexpected problem. | Please contact support@zohodirectory.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 Directory's fields with Active Directory (AD) attributes.
Error | Reason | Solution |
Custom field is deleted in Server. Delete? | The custom field was deleted in Zoho Directory, and can no longer be synced. | Delete the mapping, or add the custom field again in the Zoho Directory 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@zohodirectory.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@zohodirectory.com for help. |
Multiple Emails exists. | At least one of the user's email addresses belongs to a different Zoho Directory organization. | Ask the user to delete their existing Zoho account, or contact support@zohodirectory.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@zohodirectory.com. |
Data Access Error | The Sync Tool is unable to access your Zoho Directory 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@zohodirectory.com with your Sync Tool's log files. |
Domain not verified | The email domain is not verified in Zoho Directory. | Verify the domain and try again. |
Operation not supported | Zoho Directory's free plan does not allow syncing any more users. | Upgrade to a paid subscription and try again. |
Mandatory attribute missing | A custom field marked as mandatory in Zoho Directory 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 Directory 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 Directory 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. |
Access your files securely from anywhere
Zoho CRM Training Programs
Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.
Zoho DataPrep Personalized Demo
If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
New to Zoho Writer?
Create. Review. Publish.
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Zoho Marketing Plus?
Everything you need to run your marketing
You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.
New to Zoho Survey?
Zoho Sheet Resources
Zoho Forms Resources
New to Zoho Sign?
Zoho Sign Resources
Sign, Paperless!
New to Zoho TeamInbox?
Zoho TeamInbox Resources
New to Zoho ZeptoMail?
Design. Discuss. Deliver.
New to Zoho Workerly?
New to Zoho Recruit?
New to Zoho CRM?
New to Zoho Projects?
New to Zoho Sprints?
New to Zoho Assist?
New to Bigin?
Related Articles
Integrate Your On-premises Directory with Zoho Directory Identity Connect
Download and install the Identity Connect Agent on a machine that meets the following requirements: Supported platforms: 64-bit Windows Server 2008 or later / Windows 10 or later LDAP user credentials with read access to your directory The agent must ...Import users to Zoho Directory from other cloud identity solutions
Transferring user information from one identity provider to another can be tedious, and requires utmost care and effort, since even one mistake can lead to data breaches or loss. Zoho Directory provides you with different ways to import your users. ...Add OneLogin to Zoho Directory
Prerequisites Roles required in Zoho Directory to perform this action: Organization Owner Organization Admin Role required in OneLogin: Admin Plan required in Zoho Directory: Free plan Professional plan (if you want to add multiple directories) In ...Add CSV-as-a-source to Zoho Directory
Note: Before you install the sync tool, ensure that you meet the system requirements. Roles required in Zoho Directory to perform this action Organization owner Organization admin Steps to add CSV-as-a-source to Zoho Directory Write to ...Add BambooHR to Zoho Directory
Prerequisites: Roles required in Zoho Directory to perform this action: Organization Owner Organization Admin Roles required in BambooHR: Admin Plan dependency in Zoho Directory: Free plan In BambooHR: Log in to your BambooHR account. Click the My ...
New to Zoho LandingPage?
Zoho LandingPage Resources