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.
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.
Error: Unable to get SMTP email
Solution 1:
- Log in to Microsoft 365 admin center and go to Users > Active Users.
- Select the user whose email address is used to integrate with Zoho CRM, then click Mail in the side pane that pops out.
- Click Manage Email Apps in the Email apps section.
- Select the Authenticated SMTP setting if it is not already selected.
If the option is already selected, unselect it and select it again. 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).
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.
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.
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
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.
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.
During the IMAP/POP3 integration, there is an error message that says "Unsupported or Unrecognized SSL message" or "Could not connect to host".
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:
Go to the IMAP/POP3 configuration settings and update the password.
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:
- Navigate to Setup > Users and Control > Security Control > Zoho Mail Add-on User.
- In this section, you'll find a list of users who have configured IMAP in their CRM accounts.
- 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.
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.