Troubleshooting IMAP & POP3 Configuration

Troubleshooting IMAP & POP3 Configuration

Password/Basic Authentication Errors (Zoho Mail, Yahoo)

During the IMAP/POP3 configuration, there is an error message that says "Authentication Failure for <email id>" or "Invalid credentials" 

There are multiple reasons why you might see this error:
  • Incorrect Password: Confirm the accuracy of the entered password by logging in to your webmail using the same password. Type the password manually rather than relying on auto-fill to ensure verification.
  • TFA related Error: Verify if Two-Factor Authentication (TFA) is activated in your webmail account. If enabled, create an app-specific password within the webmail settings and apply this unique password in the IMAP/POP3 settings of your CRM.
     
If the problem persists, kindly reach out to our support team at support@zohocrm.com.

OAuth/ Modern Authentication Errors (Gmail, Outlook, Office 365, Gmail API Integration)

How do I resolve the errors that I get during Office 365/MS Outlook integration with Zoho CRM?   

During MS Outlook or Office 365 integration via IMAP-OAUTH or POP3-OAUTH protocols, if you encounter the following errors, please follow the respective steps to resolve them.
  1. Error: Unable to get SMTP email


Solution 1:
  1. Log in to Microsoft 365 admin center and go to Users > Active Users.
  2. Select the user whose email address is used to integrate with Zoho CRM, then click Mail in the side pane that pops out.
  3. Click Manage Email Apps in the Email apps section.
  4. Select the Authenticated SMTP setting if it is not already selected.
    If the option is already selected, unselect it and select it again.
  5. Click Save Changes.

      For more information about this error, click here.

Solution 2:

Microsoft Support advises users to make sure that their User Principal Name (UPN) and email address are the same in their Identity Provider (IDP).

Should these steps not rectify the problem, please reach out to the Microsoft Support Center for assistance.

 

      2. Error: User is authenticated but not connected

This issue can arise when the IMAP connection limit is surpassed. To resolve this, consider terminating any superfluous IMAP connections that have been set up, or approach Microsoft to seek an augmentation of the connection limit.

 

Should these measures prove ineffective, it is advisable to contact Microsoft support for further assistance.
  1. Scope Mismatch: Error message 'The provided resource value to the input parameter 'scope' is not valid'
    If the user attempts to integrate their Outlook account in Office 365 or vice versa, an error will be thrown. The user should ensure configuring the right MS account for the chosen provider.
To learn more about email integration with Zoho CRM, click here.

 

Why did my emails stop syncing inside my Zoho CRM account after changing my Gmail password?

This is because the password change will invalidate the OAuth token previously generated at the time of email integration due to the policy of Gmail. You will have to generate a new token to make it work again.  

 

What shall I do if I get Gmail SMTP errors?  

Refer to this support doc by Google to learn more about the Gmail SMTP error and its troubleshooting.
 

What shall I do if I get Outlook SMTP errors? 

Refer to this support doc by microsoft to learn more about the Outlook SMTP error and its troubleshooting.

During the IMAP/POP3 integration, there is an error message that says "Unsupported or Unrecognized SSL message" or "Could not connect to host". 

A connection error may occur when there is a port or server-related error while configuring IMAP/POP3 protocols in your CRM account.
  • Port related Error:
  1. Ensure that the accepted port numbers for IMAP/POP3 are correctly entered:
    • Ports for incoming emails: 993 and 143
    • Ports for outgoing emails: 465, 587, and 25
  1. Confirm the status of open ports. Visit https://zohomail.tools/#portCheck and input the server name and port number. If the ports are closed, contact your email service provider to open them.
  2. If the ports are open but you still encounter a connection error, attempt setting up IMAP/POP3 with the same server details in alternative applications such as MS Outlook, Thunderbird, and so on. If successful in other applications but not in Zoho CRM, reach out to our support team support@zohocrm.com.

  • Server related Error:

    1. Verify that the server details are accurate. To confirm, visit https://zohomail.tools/#domainDetails and input the domain name to identify the email service provider.
    2. During the IMAP/POP3 integration, there is an error message that says "Unsupported or Unrecognized SSL message" or "Could not connect to host".
    3. Authentication takes a long time, followed by the "Server Disconnected" error message. 
      In most cases, this indicates that the server details are incorrect. Confirm your email service provider by visiting https://zohomail.tools/#portCheck and entering the domain name associated with your email address. Once you identify your email service provider, input the accurate server details and attempt the operation again.

 

During the IMAP/POP3 configuration, there is an error message that says "Authentication Failure for <email id>" or "Application specific password required" 

Please refer to the above Password/Basic Authentication section on this page.

I am unable to send an email and I 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.

To fix the issue:
  1. Go to the IMAP/POP3 configuration settings and update the password.
  2. Ensure that the password is also updated in the outgoing mail server details.


An email is getting 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 appear duplicated. The Store sent messages on the server option is available because some SMTP servers do not automatically save sent emails. Enabling this option is beneficial for servers that don't save sent mail by default.
However, if this feature is turned on for SMTP servers that already save sent emails by default, it may result in having duplicate emails in the inbox. To display the emails only once, please disable this checkbox.

My account is not enabled for IMAP access. 

Enable IMAP in your mail provider settings.


TFA is not enabled in mail server but while typing password am getting "Authentication Failure for <email address> 

You are likely typing the wrong password for your mailbox. Double check that you are using the correct password and try again.

What should users do when they experience connection issues? The message displayed in the screenshots below provides guidance.






Users should deactivate and reconfigure their email configuration to resolve the connection issues. This will allow them to continue sending and syncing emails in Zoho CRM.


Common Errors:  


Open your webmail and verify the presence of emails in the Inbox or Sent Item folder. All emails in these folders will be synchronized with CRM. Ensure that you check the folders enabled to "View in IMAP" within the web version of your email account, rather than in other applications like MS Outlook, as the IMAP sync is exclusively with webmail.

If the emails are visible in webmail but not in CRM, please reach out to our support team.

"Cannot complete email configuration as the email account you are trying to integrate has already been used by another user <<User name>> within you organization.



This indicates that the email address has already been utilized for IMAP/POP3 configuration in another CRM account. To remove the account, an admin can go to the Zoho Mail Add-on Users page from CRM Settings. In the User List section, click the Delete Configuration button against the user account name that was mentioned in the error message.



If this solution does not resolve the issue, or if you are unsure about the account in which it is configured, please contact our support team.

Why am I unable to make changes in my email configuration screen despite having an Administrator profile? 


This disabled screen indicates that your email configuration settings are locked, and another administrator needs to unlock it for you.

To resolve this:
  1. Navigate to Setup > Users and Control > Security Control > Zoho Mail Add-on User.
  2. In this section, you'll find a list of users who have configured IMAP in their CRM accounts.
  3. Once an administrator unlocks the configuration settings for you, you will gain access to the Email Setup page.
Note: If an administrator encounters this issue, they will require assistance from another administrator to unlock the configuration.

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


Users who lack Email Integration permission in their profile settings will encounter an error when accessing the Emails tab under Channels.

To grant this permission, navigate to Setup > Security Control > Profiles, select the relevant profile, and enable permissions under Setup Permissions > Email & Templates. 

What should you do if you encounter issues syncing emails in CRM using the POP3 protocol?

The POP server has a threshold limit of 50,000 emails. If the number of emails in the POP server exceeds this limit, the server will not allow further email syncing, and the 'POP Threshold Reached' message will be displayed. If the email count surpasses 50,000, users should enable the 'delete messages immediately after fetching' option when configuring their mailbox. Without this setting, emails exceeding the 50,000 limit will not be synced.

    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









                                            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

                                                                                                              • Email Configuration for IMAP and POP3

                                                                                                                Zoho CRM supports email integration from any email service through IMAP and POP3 protocols, allowing for seamless synchronization and management of email communication within the platform. Additionally, Zoho CRM provides specialized email integration ...
                                                                                                              • Email Configuration IMAP

                                                                                                                Configuring your email account with Zoho CRM via IMAP configuration has been 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 Zoho CRM’s email cleanup ...
                                                                                                              • FAQs: Email Configuration

                                                                                                                What is IMAP and POP/POP3 protocols in Zoho CRM? Zoho CRM allows you to engage with customers by sending and receiving emails from within your CRM, or sync third-party email accounts to CRM via IMAP or POP/POP3 protocols. IMAP is a protocol that ...
                                                                                                              • 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 SalesInbox

                                                                                                                Why are some emails not showing up in SalesInbox? There are several reasons emails might not show up in SalesInbox: Folder Mapping: SalesInbox relies on folder mapping between your email account and CRM. If the emails are in folders that haven’t been ...
                                                                                                                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