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:
  1. Troubleshoot Email errors
  2. Enable IMAP and SMTP settings
  3. Generate HTTP Archive (HAR) files

Troubleshoot Email errors

The following table provides details on the different errors and the corresponding troubleshooting steps:

Error MessageReason for errorHow to resolve this?
Error while verifying the mailbox imap details. Please verify server name, port and credentials

This occurs due to:

  • Incorrect configuration, such as invalid port number, and wrong credentials
  • Invalid TLS certificate
  • Mailbox IP restrictions

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

  2. 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 on Freshdesk’s Email Settings page.

  3. Verify your TLS certificate

  4. Check Email IP Whitelisting
    If the issue still persists, verify if the required Email IPs are whitelisted in your network or email server settings. This ensures that Freshdesk can securely connect to your email server.

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:

  1. Go to Admin Settings > Email > Custom Email Server.

  2. Click on the Sign-in button on the Email Configuration page.

    You will be redirected to your OAuth provider’s login page (Gmail or Microsoft 365).

  3. After successful login, a new access token will be automatically generated.
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.

For example, an invalid port number or mailbox IP restriction.

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

  2. 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 on Freshdesk’s Email Settings page.

  3. Check Email IP Whitelisting
    If the issue still persists, verify if the required Email IPs are whitelisted in your network or email server settings. This ensures that Freshdesk can securely connected to your email server. 
Error while authenticating the SMTP server. Please verify server name, port, and credentials

This occurs due to:

  • Incorrect configuration, such as invalid port number, and wrong credentials
  • Invalid TLS certificate
  • Mailbox IP restrictions


  1. For Gmail or Microsoft Office 365 users:
    Ensure that SMTP is enabled in your Gmail or Microsoft Office 365 settings. For instructions, see Enable IMAP and SMTP settings.

  2. 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 on Freshdesk’s Email Settings page.

  3. Verify your TLS certificate

  4. Check Email IP Whitelisting
    If the issue still persists, verify if the required Email IPs are whitelisted in your network or email server settings. This ensures that Freshdesk can securely connect to your email server.
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.

  1. Open the Microsoft 365 admin center using Office 365 credentials and go to Users > Active users.
  2. Select the user with the custom mailbox configuration, and in the pop-up that appears, click the Mail tab.
  3. In the Email Apps section, click Manage Email Apps.
  4. In the Manage email apps pane, ensure “IMAP” and “Authenticated SMTP” options are enabled.
  5. 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:

  1. Generate HAR file in Google Chrome
  2. Generate HAR file in Firefox
  3. Generate HAR file in Safari
  4. Generate HAR file in Edge

Generate HAR file in Google Chrome

  1. Close all incognito windows in Google Chrome.
  2. Open a new incognito window in Google Chrome.
  3. Go to View > Developer > Developers Tools.
  4. In the Developer Tools pane, choose the Network tab.
  5. Enable the Preserve Log checkbox to record all interactions.
  6. Visit the page and complete the steps that trigger the issue.
  7. Choose the Network tab.
  8. Click the down arrow to export the HAR file.
  9. Save the HAR file.

Generate HAR file Safari

Ensure that Show Develop menu in menu bar checkbox is checked under Safari > Preferences > Advanced.

  1. Choose File > Open New Private Window.
  2. Choose Show Web Inspector in the Developer menu and navigate to the Network tab.
  3. Click on the Filter button and choose Preserve Log.
  4. Visit the web page where the issue occurs.
  5. Choose Develop > Show Web Inspector. The Web Inspector window appears.
  6. Complete the steps on the page that trigger the issue.
  7. Select the Network tab.
  8. Click Export on the top-right corner and save the HAR file.

Generate HAR file in Firefox

  1. Close all private windows in Firefox.
  2. Open a new private window in Firefox.
  3. Go to Tools > Developer > Network (Ctrl + Shift + E).
  4. Click the Network tab and choose Persist Logs.
  5. Visit the page and complete the steps that trigger the issue.
  6. Choose the Network tab and right click and then select Save All As Har.
  7. Save the HAR file.

Generate HAR file in Microsoft Edge

  1. Close all InPrivate windows in Microsoft Edge.
  2. Open a new InPrivate window (Ctrl + Shift + N).
  3. Go to Settings and more and choose More Tools > Developer Tools.
  4. Start a profiling session on the Network tab of the Developer Tools toolbar.
  5. Visit the page and complete the steps that trigger the issue.
  6. Select Export as HAR (Ctrl + S) and save the HAR file