Sync Tool - Troubleshooting | Admin Guide - Zoho Directory

Zoho Directory Sync Tool - Troubleshooting


Roles required to perform this action:
  1. Organization Owner
  2. Organization Admin


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.
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 to obtain the correct configuration.
Only one instance of the tool can be used for an organization. Please contact support.
You're trying to sign in to a second instance of the tool, for the same organization.
General Error
The operation failed due to some unexpected problem.
Please contact 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.

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


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 for help.
Request Failed / Server Error
The server might not be reachable from your system, or a data mismatch might have occurred.
Please contact 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 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
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 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.

Password Sync screen

This error may be shown when you're trying to install the Password Sync Agent in your domain controllers.
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.

    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 CRM Training
      Redefine the way you work
      with Zoho Workplace

        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 CRM Training

          Create, share, and deliver

          beautiful slides from anywhere.

          Get Started Now

            Zoho Sign now offers specialized one-on-one training for both administrators and developers.

            BOOK A SESSION

                                      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.

                                          Manage your brands on social media

                                            Zoho Desk Resources

                                            • Desk Community Learning Series

                                            • Digest

                                            • Functions

                                            • Meetups

                                            • Kbase

                                            • Resources

                                            • Glossary

                                            • Desk Marketplace

                                            • MVP Corner

                                            • Word of the Day

                                              Zoho Marketing Automation

                                                Zoho Sheet Resources


                                                    Zoho Forms Resources

                                                      Secure your business
                                                      communication with Zoho Mail

                                                      Mail on the move with
                                                      Zoho Mail mobile application

                                                        Stay on top of your schedule
                                                        at all times

                                                        Carry your calendar with you
                                                        Anytime, anywhere

                                                              Zoho Sign Resources

                                                                Sign, Paperless!

                                                                Sign and send business documents on the go!

                                                                Get Started Now

                                                                        Zoho TeamInbox Resources

                                                                                Zoho DataPrep Resources

                                                                                  Zoho DataPrep Demo

                                                                                  Get a personalized demo or POC

                                                                                  REGISTER NOW

                                                                                    Design. Discuss. Deliver.

                                                                                    Create visually engaging stories with Zoho Show.

                                                                                    Get Started Now

                                                                                                        • Related Articles

                                                                                                        • Zoho Directory Sync Tool - Overview

                                                                                                          Zoho Directory Sync Tool performs a one-way synchronization from your existing LDAP server to the Zoho Directory Admin Panel. This enables you to maintain all your user identities in a single place, without having to add, edit, or disable user ...
                                                                                                        • Sync from Active Directory/LDAP server

                                                                                                          Sync from Active Directory/LDAP Note: Before you install the Zoho Directory sync tool, ensure that you meet the system requirements. Prerequisites Roles required to perform this action: Organization owner Organization admin Sync from Active ...
                                                                                                        • Reset tool

                                                                                                          Prerequisites The Sync Tool must have been installed and run at least once. Roles required to perform this action: Organization Owner Organization Admin Reset tool Open the Sync Tool. Go to Settings. Click Reset Zoho Directory Sync Tool, then Delete. ...
                                                                                                        • Sync passwords

                                                                                                          Prerequisites The Sync Tool must have been installed and run at least once. Roles required to perform this action: Organization Owner Organization Admin Sync passwords Open the Sync Tool. Go to Password Sync, then click Install Agent. Choose the ...
                                                                                                        • Schedule sync

                                                                                                          Prerequisites The Sync Tool must have been installed and run at least once. Roles required to perform this action: Organization Owner Organization Admin Schedule sync Open the Sync Tool. Go to Schedule Sync, then enable scheduling. Set the sync ...
                                                                                                          Wherever you are is as good as
                                                                                                          your workplace



                                                                                                            Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.


                                                                                                            Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.


                                                                                                            Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.

                                                                                                            CRM Tips

                                                                                                            Make the most of Zoho CRM with these useful tips.

                                                                                                              Zoho Show Resources