Microsoft is going to deprecate the support for Basic Authentication on online exchange servers due to security protocols. Going forward, Microsoft will only support OAuth for Microsoft Office 356 servers. Click here to learn more.


OAuth is an open-standard authorization protocol or framework that provides applications the ability to secure designated access. OAuth doesn’t share password data and instead uses authorization tokens to prove an identity between consumers and service providers. OAuth is an authentication protocol that allows you to approve one application interacting with another on your behalf without giving away your password.

If you are using Microsoft as a custom mail server in Freshdesk and if you have already configured basic authentication, then : 

1. You will see a banner inside your helpdesk as shown below:





2. Go to Admin> Email and click to Re-authorize the account. Once you enter the ‘Username and Password’, the authorization will be confirmed and the existing Microsoft configuration will be replaced with the OAuth-based Microsoft configuration. 




3. The migration takes place in the backend and you will need to re-authorize it with your Microsoft credentials.
4. This migration will not have any impact on your helpdesk activities nor on any email incoming/outgoing activities. 

5. Once the authentication is successful, you will see a confirmation message.

6. If you see any errors as shown below, enable IMAP and Authenticated SMTP to authenticate.







If you are a 
new customer setting up the Microsoft OAuth for the first time,  go to Admin > Email > New support email > Use your own mail server.

1. You can choose to use the mail server for ‘Incoming only’, ‘Outgoing Only’ or ‘Both’.

2. For ‘Incoming only’ and ‘Both’, you will be able to delete emails from the server after fetching it to Freshdesk.

3. Authenticate OAuth2.0 using your Microsoft credentials. Once the authentication is successful, you will see a confirmation message.



Modification of Email Configuration:

1. If you are already using a Microsoft account and want to switch to another new Microsoft account for OAuth, enter the credentials for the new account and follow the normal procedure.

2. If you are using a Gmail account and want to switch to Microsoft account for OAuth, choose Microsoft Office 365, sign in with Microsoft, and follow the normal procedure.

Note : 

  • Existing basic authentication details can be viewed in the ‘Others’ section. 
  • The reauthorization message can also be seen for accounts whose password has expired or changed. In that case, you must reauthorize your account as mentioned above for Microsoft office 365 and Gmail server. But for other custom servers, provide a username and password again.
  • We also support OAuth for personal accounts like Outlook.com and hotmail.com 
  • Click here to read more on how to use the custom mail servers for incoming and outgoing emails.