Microsoft OAuth Setup for Unipile

To connect Microsoft accounts to Unipile via OAuth authentication, you need to register your app in Azure Active Directory (AAD). You will then configure Unipile to use your AAD application ID. If you encounter any difficulties registering your application in Azure AD, contact-us, and we'll be happy to assist you!

Create Your Free Microsoft Azure Account

If you don't already have one, create your free Microsoft Azure account. You will use this account to create the Microsoft developer application used for authenticating end-users via OAuth with Unipile.

Creating an App Registration

• Log in to https://portal.azure.com and go to the Microsoft Entra ID (previously Azure Active Directory) service.

• Click on "New registration".

• You will be presented with the following screen:

1. Name your app (this name will be visible to customers).
2. Set the audience for this app to the second option "Accounts in any organizational directory (Any Microsoft Entra ID - Multitenant) and personal Microsoft accounts (e. g. Skype, Xbox)" to be able to log in to any Office 365 account (business and personal).
3. Specify a redirect URI: https://auth.unipile.com/v1/oauth/callback

Specifying API Permissions

Ensure your app has the correct API permissions:

• Head to the "API permissions" panel and click "Add a permission".

• Choose the Microsoft Graph set of permissions.

• Then add all required Delegated permissions: Mail.ReadWrite, Mail.Send, Mail.Read

This is what your application permissions screen should look like.

Creating OAuth Credentials

• Head to the "Certificates & secrets" panel and click "New client secret".

• Name the secret and set an expiration date of "Never", then click "Add".

• Copy the secret to a safe place. You won't be able to retrieve it from this page afterward!

Finally, copy the app ID and secret and upload them to the Unipile Dashboard.

Configure Unipile to Use Your Microsoft OAuth Credentials

Go to the Unipile Dashboard and log in.

Choose the Settings menu, and switch to the Microsoft Oauth part.

Copy-paste the Azure Client ID from the App registration page AND the Value from the Azure Clients secrets page and click "Save".

You are now all set to start connecting Microsoft accounts to Unipile.