Troubleshooting IMAPs | Zoho CRM Help

Troubleshooting IMAPs

1. During the IMAP 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:
  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 https://zohomail.tools/#domainDetails and enter the domain name to check who the email service provider is.

III. Check whether the ports are open. Go to https://zohomail.tools/#portCheck 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 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:https://www.arclab.com/en/kb/email/list-of-smtp-and-imap-servers-mailserver-list.html
2. During the IMAP 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 settings.
If the issue still persists, please contact our support team (support@zohocrm.com).
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 https://zohomail.tools/#portCheck 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 settings.

  1. Go to the IMAP 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. Please use a different account" error shown when I go to the IMAP setup

This means that the email address has already been used for IMAP configuration in another CRM account. If you know the account it has been configured in, deactivate the IMAP in that account and then try configuring IMAP 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 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 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.

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

                  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

                                                          • 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 ...
                                                          • Troubleshooting Data Backup

                                                            1. My scheduled data backup is not ready for download in CRM. What should I do? The screenshot below is the default data backup screen in Zoho CRM and will appear when there is no data backup schedules. The screenshot below shows what the page 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 ...
                                                          • Troubleshooting Email Authentication

                                                            1. I am getting an error which says "DKIM record missing". After entering the public key value in you domain settings page, go to https://zohomail.tools/#domainDetails and select TXT. Enter the public key value you generated in CRM and select Lookup. ...
                                                          • Troubleshooting Workflows

                                                            1. A workflow was not triggered for some records. Confirm the source of the record. Make sure it was not created from the Sheet view or via import. If the record source is API , "trigger["workflow"]" must be included in the API json body. The ...

                                                          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