Sync Tool - Troubleshooting | Admin Guide - Zoho One

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

      Create. Review. Publish.

      Write, edit, collaborate on, and publish documents to different content management platforms.

      Get Started Now


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





                              Quick Links Workflow Automation Data Collection
                              Web Forms Enterprise Begin Data Collection
                              Interactive Forms Workplace Data Collection App
                              CRM Forms Customer Service Accessible Forms
                              Digital Forms Marketing Forms for Small Business
                              HTML Forms Education Forms for Enterprise
                              Contact Forms E-commerce Forms for any business
                              Lead Generation Forms Healthcare Forms for Startups
                              Wordpress Forms Customer onboarding Order Forms for Small Business
                              No Code Forms Construction RSVP tool for holidays
                              Free Forms Travel
                              Prefill Forms Non-Profit

                              Intake Forms Legal
                              Mobile App
                              Form Designer HR
                              Mobile Forms
                              Card Forms Food Offline Forms
                              Assign Forms Photography
                              Mobile Forms Features
                              Translate Forms Real Estate Kiosk in Mobile Forms
                              Electronic Forms

                              Notification Emails for Forms Alternatives Security & Compliance
                              Holiday Forms Google Forms alternative  GDPR
                              Form to PDF Jotform alternative HIPAA Forms
                              Email Forms
                              Encrypted Forms
                              Embeddable Forms
                              Secure Forms
                              Drag & drop form builder
                              WCAG

                                    Create. Review. Publish.

                                    Write, edit, collaborate on, and publish documents to different content management platforms.

                                    Get Started Now




                                                      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


                                                            • Desk Community Learning Series


                                                            • Digest


                                                            • Functions


                                                            • Meetups


                                                            • Kbase


                                                            • Resources


                                                            • Glossary


                                                            • Desk Marketplace


                                                            • MVP Corner


                                                            • Word of the Day


                                                            • Ask the Experts


                                                              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 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 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 ...
                                                                                                                      • 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
                                                                                                                      • Cannot sign in to AD Sync Tool

                                                                                                                        Description You may face this error when: you're trying to sign in to Zoho One/Directory's AD Sync Tool. you're trying to reassign the ownership of the AD Sync Tool to a different Zoho One/Directory admin. Reason The AD Sync Tool requires Internet ...
                                                                                                                      • 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 Directory Stores. Under Active Directory, click Add. Click Download. Install the ...
                                                                                                                      • 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 ...
                                                                                                                        Wherever you are is as good as
                                                                                                                        your workplace

                                                                                                                          Resources

                                                                                                                          Videos

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



                                                                                                                          eBooks

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



                                                                                                                          Webinars

                                                                                                                          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