Troubleshooting IMAP | Zoho CRM Help

Troubleshooting IMAP/POP3

1. During the IMAP/POP3 integration, there is an error message which says "Connect Error" or "Unable to connect".

I. Make sure to enter the accepted port numbers for IMAP/POP3:
  1. Ports for incoming: 993 and 143
  2. Ports for outgoing: 465, 587, and 25
II. Ensure that you are entering the correct server details. To confirm whether the server details are correct, go to and enter the domain name to check who the email service provider is.

III. Check whether the ports are open. Go to and enter the server name and port number. If the ports are closed, then check with the email service provider to open the ports.

IV. If the ports are open and you are still getting the connect error, try setting up the IMAP/POP3 with the same server details in other applications like MS Outlook, Thunderbird, etc. If it works in the other applications and the error is only in Zoho CRM then you can contact our support team and check with your email service provider to get the correct server details.

V. Check this link to ensure you are using the correct port number:
2. During the IMAP/POP3 configuration, there is an error message which says "Authentication Failed" or "Invalid credentials"

  1. Make sure that the password you entered is correct. To verify the password, log in to your webmail with the same password by typing in the password instead of using auto-fill.
  2. Check whether TFA is enabled in webmail. If it is enabled, generate an app-specific password in the webmail and use the app-specific password in CRM's IMAP/POP3 settings.
If the issue still persists, please contact our support team (
3. Authentication takes a long time, followed by the "Server Disconnected" error message. 
In most cases, this means that server details are incorrect. Confirm who your email service provider is by going to and entering the domain name of your email address. Once you find out who your email service provider is, enter the correct server details and try again.

4. I am unable to send an email and am seeing the "Authentication unsuccessful" error message.

This happens when the password is incorrect or has expired for the outgoing server details in IMAP/POP3 settings.

  1. Go to the IMAP/POP3 settings and update the password.
  2. Ensure that the password is also updated in the outgoing mail server details.
5. Some emails are not displayed in the Emails related list of records.
Open your webmail and check whether the emails are available in the Inbox or Sent Item folder. All the emails in these folders will be synced with CRM. Check the folders in the web version of your email account and not in other applications like MS Outlook as the IMAP sync is only with webmail.
If the emails are present in webmail and not in CRM, contact our support team.
6. "You cannot use this account as it has been used to configure IMAP/POP3. Please use a different account" error shown when I go to the IMAP/POP3 setup

This means that the email address has already been used for IMAP/POP3 configuration in another CRM account. If you know the account it has been configured in, deactivate the IMAP/POP3 in that account and then try configuring IMAP/POP3 in the correct account. If this does not work or you do not know which account it is configured in, contact our support team. 
7. Even though I am a user with the Administrator profile, I get the following error message when I open the Email Settings page: "Permission Denied. Contact your administrator."

This means that another user with the administrator profile has locked the IMAP/POP3 configuration. It must be unlocked before you can access the email settings.
To unlock the configuration,
  1. Go to Setup > Users and Control > Security Control > Zoho Mail Add-on User. 
  2. Click the Unlock Configuration button next to the user's name.
8. An email displayed twice in my CRM account. 
If the Store sent messages on the server checkbox is enabled in the IMAP/POP3 Settings page, the emails will be displayed twice. Disable this checkbox to show the emails only once.

9. I get the following error message when I go to Setup > Channels > Emails: "You do not have sufficient permissions to perform this operation. Contact your administrator."

This error message means your email configuration settings are locked. A user with the Administrator profile needs to unlock it for you.
  1. Go to Setup > Users and Control > Security Control > Zoho Mail Add-on User.
  2. The users who have configured IMAP in their CRM accounts are listed here. Once an admin has unlocked configuration settings for you, you will be able to access the Email Setup page. 

If an administrator runs into this issue, they will need another administrator to unlock the configuration for them.

See also: 

    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

                        Still can't find what you're looking for?

                        Write to us:



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

                                                        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

                                                                                          • Email Configuration for IMAP and POP

                                                                                            This feature is opened in a phased manner and will be accessible only to the selected users. In Zoho CRM emails can be integrated from any service provider through IMAP and POP. In addition, email integration can also be provided through API for ...
                                                                                          • Troubleshooting Email Relay

                                                                                            1. Why am I getting an authentication failure error? Make sure that the password you entered is correct. To verify the password, log in to your webmail with the same password by typing in the password instead of using auto-fill. Check whether TFA is ...
                                                                                          • Configuring POP Account

                                                                                            Configuring your email account with Zoho CRM via POP3 protocol is updated and is being released in a phased manner. For those organizations with the new update, click here to learn more. Set up email account via POP3 Zoho CRM lets you configure a ...
                                                                                          • Configuring IMAP Account

                                                                                            Configuring your email account with Zoho CRM via IMAP protocol is updated and is being released in a phased manner. For those organizations with the new update, click here to learn more. Cleanup Policy As part of our cleanup policy the IMAP sync will ...
                                                                                          • Troubleshooting Email Templates

                                                                                            1. Product details are not populated in the table created in a template. Product details will only be available if the default product table in the template has been added. If the fields in the Product Details section are added separately, the values ...
                                                                                          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