This article provides troubleshooting steps for all the common error scenarios and error messages that you may encounter while setting up and configuring custom email servers in Freshdesk.
This article includes: |
Troubleshoot Email errors
The following table provides details on the different errors and the corresponding troubleshooting steps:
Error Message | Reason for error | How to resolve this? |
---|---|---|
Error while verifying the mailbox imap details. Please verify server name, port and credentials. | This occurs due to:
|
|
Error refreshing access token. | This indicates that your Oauth token may be expired. | Reauthenticate your access token on your account (Gmail or Microsoft 365) again. To reauthenticate:
|
Specified IMAP mail server is not supported. Please use a different one. | This indicates that your client-side IMAP is disabled. | Ensure that the IDLE feature is enabled in the IMAP server settings of your accounts. To enable the IDLE feature in Microsoft 365, see Enable IDLE in Microsoft 365. For other email accounts, check with your respective Email service providers. |
Could not connect to the IMAP server. Please verify server name, port and credential. | This occurs due to any incorrect configuration. |
|
Error while authenticating the SMTP server. Please verify server name, port, and credentials. | This occurs due to:
|
|
Error: Email sending limit exceeded | This occurs to prevent the delivery of unsolicited bulk messages and ensure fair usage of our resources. | Monitor your email sending volume to stay within the daily limit. For Office 365 users: Users and applications are currently restricted to sending 10,000 emails per day for Office 365. Additionally, a new daily External Recipient Rate (ERR) limit of 2,000 recipients for Outlook will be introduced in 2025. If the daily sending limit is exceeded, it can cause mailbox disconnection. For more information on Gmail sending limits, visit the support page: Gmail Sending Limits. |
Could not connect to the smtp server. Please verify server name, port and credentials. | This indicates that the TLS certificate expired or an unsupported TLS version is used on the client side. | Update the TLS certificate of the email domain in your domain service provider. |
Timed out while authenticating the SMTP server. | This occurs due to an invalid auth, port number or IP restriction. | For Gmail or Microsoft Office 365 users: Ensure that IMAP is enabled in your Gmail or Microsoft Office 365 settings. For instructions, see Enable IMAP and SMTP settings. For other Custom Servers users: Verify the server name, port, and credentials for your custom email server. Ensure that you have entered the correct information in Freshdesk’s Email Settings page. |
We're sorry, something went wrong. Please try again later. | Please contact us at support@freshdesk.com with the HAR logs. To know how to generate HAR files on different browsers, check Generate HTTP Archive (HAR) files. | |
Freshdesk is unable to send emails for custom mailbox; Please reauthorize. | You may receive an email notification with this error when there is a timeout error and Freshdesk tries to connect with the SMTP server of your mailbox. | Reauthorize your custom mailbox. For instructions, see Reauthorization of custom mailbox. |
Something went wrong. We are unable to connect to your custom mailbox. View details. | This occurs when Freshdesk tries to connect to your mailbox and if the connection is not passed successfully. | Reauthorize your custom mailbox. For instructions, see Reauthorization of custom mailbox. |
Enable IMAP and SMTP settings
Microsoft Office 365
If you use Microsoft Office 365 as custom mail server, check if SMTP is enabled on your mailbox.
- Open the Microsoft 365 admin center using Office 365 credentials and go to Users > Active users.
- Select the user with the custom mailbox configuration, and in the pop-up that appears, click the Mail tab.
- In the Email Apps section, click Manage Email Apps.
- In the Manage email apps pane, ensure “IMAP” and “Authenticated SMTP” options are enabled.
- Click Save.
Note: Most Microsoft Office 365 tenants have SMTP authentication disabled by default. You can enable it if required. It takes about 30 minutes for the permissions to take effect. For more details, see this article.
Gmail
If you use Gmail, check your IMAP and SMTP settings under Gmail account > Settings.
Generate HTTP Archive (HAR) files
The HAR is a JSON-formatted archive file format that captures a web browser's interaction with a Website.
If you are still having trouble resolving errors while setting up emails with Custom Email Server, please send us the HAR files at support@freshdesk.com.
Here’ s how you can generate HAR files in various browsers:
- Generate HAR file in Google Chrome
- Generate HAR file in Firefox
- Generate HAR file in Safari
- Generate HAR file in Edge
Generate HAR file in Google Chrome
- Close all incognito windows in Google Chrome.
- Open a new incognito window in Google Chrome.
- Go to View > Developer > Developers Tools.
- In the Developer Tools pane, choose the Network tab.
- Enable the Preserve Log checkbox to record all interactions.
- Visit the page and complete the steps that trigger the issue.
- Choose the Network tab.
- Click the down arrow to export the HAR file.
- Save the HAR file.
Generate HAR file Safari
Ensure that Show Develop menu in menu bar checkbox is checked under Safari > Preferences > Advanced.
- Choose File > Open New Private Window.
- Choose Show Web Inspector in the Developer menu and navigate to the Network tab.
- Click on the Filter button and choose Preserve Log.
- Visit the web page where the issue occurs.
- Choose Develop > Show Web Inspector. The Web Inspector window appears.
- Complete the steps on the page that trigger the issue.
- Select the Network tab.
- Click Export on the top-right corner and save the HAR file.
Generate HAR file in Firefox
- Close all private windows in Firefox.
- Open a new private window in Firefox.
- Go to Tools > Developer > Network (Ctrl + Shift + E).
- Click the Network tab and choose Persist Logs.
- Visit the page and complete the steps that trigger the issue.
- Choose the Network tab and right click and then select Save All As Har.
- Save the HAR file.
Generate HAR file in Microsoft Edge
- Close all InPrivate windows in Microsoft Edge.
- Open a new InPrivate window (Ctrl + Shift + N).
- Go to Settings and more and choose More Tools > Developer Tools.
- Start a profiling session on the Network tab of the Developer Tools toolbar.
- Visit the page and complete the steps that trigger the issue.
- Select Export as HAR (Ctrl + S) and save the HAR file