If you see a banner stating, "Please reauthorize your Email settings. Learn more about it here or finish the setup in Email settings," follow the detailed steps based on your scenario to reauthorize your email settings and ensure uninterrupted service. 

This article contains:


Scenario 1: Microsoft Basic Authentication Depreciation and Migration to OAuth

Microsoft has deprecated Basic Authentication on online Exchange servers due to security protocols. OAuth, an open-standard authorization protocol, will replace Basic Authentication. OAuth secures designated access using authorization tokens, enhancing security without sharing password data.


If you use Microsoft as a custom mail server in Freshdesk and have already configured basic authentication, you will see a banner inside your helpdesk.


Follow the steps below to reauthorize your email.

  1. Navigate to Admin > Channels > Email.
  2. Click on Microsoft Office 365 and use Sign in with Microsoft to reauthorize your support mailbox.
  3. Enter your Microsoft credentials (username and password) to complete the reauthorization.
  4. The existing configuration will be replaced with OAuth-based configuration.
  5. Successful authentication will be confirmed with a message.

Note: This migration does not impact your helpdesk activities or email operations.


If you encounter errors in verifying the server name, port, and credentials: 

  1. Enable IMAP and Authenticated SMTP for authentication.

For New Microsoft OAuth Setup:

  1. Navigate to Admin > Channels > Email > New support email.
  2. Choose to use the mail server for Incoming only, Outgoing only, or Both.
  3. For Incoming only and Both, you can opt to delete emails from the server after fetching them to Freshdesk.
  4. Authenticate OAuth 2.0 using your Microsoft credentials. Successful authentication will be confirmed with a message.

Modifying Email Configuration:

  1. To switch to a new Microsoft account, enter the new account credentials and follow the normal procedure.
  2. To switch from a Gmail account to a Microsoft account, choose Microsoft Office 365, sign in with Microsoft, and follow the normal procedure.
Notes: 
1. View existing basic authentication details in the Others section. 
2. Provide the primary email address in the Your support email section if using a shared mailbox. 
3. OAuth is supported for personal accounts like Outlook.com and Hotmail.com.


You can refer to the using custom mail servers for incoming and outgoing emails to learn more.

Scenario 2: Reauthorization Required for Other and Gmail Mailbox

If you use the Gmail mailbox or the Other option and see a Reauthorization required message in Email settings, your password might have expired or changed. 

Check your username and provide your password again to reauthorize.

Scenario 3: Reauthorization Required for Microsoft Office 365 OAuth Mailbox

If using a Microsoft Office 365 mailbox, check if you've migrated to OAuth. If not, follow the steps in Case 1. If you have, and see a message, "Your Microsoft Office 365 credentials have expired. Please sign in again":

  1. Click on Sign in with Microsoft to complete the reauthorization.
  2. Click on the Save button after each step to complete the authorization.

Scenario 4: Accounts with Multiple Support Emails

If the issue persists for accounts with multiple support emails, follow the steps below 

  • Navigate to Admin > Email.
  • Make the primary email non-primary.
  • Reauthorize the email.
  • Make the email primary again.

FAQ

Q: Why do Microsoft credentials expire?

A: Microsoft credentials can expire for several reasons, such as password changes, caching conflicts, account closure, or inactivity. If using Microsoft as a custom mail server in Freshdesk, reauthorize your support mailbox by going to Admin > Channels > Email, clicking on Microsoft Office 365, and using Sign in with Microsoft.