How to get your Microsoft Active Directory OAuth 2 credentials

September 10, 2024

This guide will show you how to obtain your OAuth 2 credentials for Microsoft Azure Active Directory, which are needed for integrations with Microsoft Outlook, Microsoft Teams, and Microsoft Active Directory.

Register an app in Microsoft Azure Portal

1. Navigate to Microsoft Azure Portal
2. Search for Azure Active Directory and select it.
   
3. From the sidebar, under Manage, click App registrations and then New registration.
   
4. Fill in the following form to register a new app:
   1. Enter any name you'd like for your app.
   2. Select Accounts in any organizational directory (Any Azure AD directory - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox) to allow anyone to log in.
   3. Under Redirect URI, enter https://api.unified.to/oauth/code
   4. Click Register.
   
   

Get your client ID and client secret

1. After registering your app and on the resulting page, copy the Client ID (found next to Application (client) ID)
2. Click on Add a certificate or secret (found next to Client credentials)
   
3. Under Client secrets (0), click New client secret.
   
4. Click Add - do not change anything else in the dialog.
   
5. On the next page, copy the Value
   

Enter your OAuth credentials on Unified.to

1. Take note of your Microsoft client ID and client secret from the above steps
2. Navigate to the app.unified.to and find the integration page for the Microsoft integration you are interested in e.g. https://app.unified.to/integrations/microsoft_ad
3. Enter your client ID
4. Enter your client secret
   
5. Make sure that you enable the correct permission scopes for your application.
   

Troubleshooting

I'm getting an "invalid client secret" error

This error indicates a problem with the client ID and/or secret that you generated. Please ensure you copied the correct values to the integration settings page on Unified.to, or regenerate these credentials in Microsoft Azure Active Directory and then try again.