How to Integrate with Microsoft Azure Active Directory (AD)
This guide explains how to set up Single Sign-On (SSO) integration with Microsoft Entra ID (formerly Azure Active Directory, Azure AD) for your Hellotracks Business account.
Ensure that this process is carried out by an Administrator.
Step 1: Log in to the Microsoft Azure portal and open your directory (Microsoft Entra ID, shown as Default Directory in many accounts).
Step 2: In the + Add menu, click App registration.

Step 3: Register your Hellotracks application.
- Enter the information as it is presented in the screenshot below:
- Name: e.g. Hellotracks
- Redirect URL: Choose Web and set https://auth.hellotracks.com/v1/callback.
- Click Register.

Step 4: Create a new Client Secret.
- After creating the Application, go to Add a certificate or Secret or in Certificates & secrets,
- Click + New client secret.
- Then, click Add.

Step 5: Keep a copy of your secret Value (not Secret ID) as you will need this for Hellotracks.

Step 6: Assign Users and Groups to the Hellotracks App.
- Only users assigned to this app will have access to Hellotracks via SSO.
- You can assign users to the app by clicking the link below Managed application in local directory on the app overview page.

Configure the app within Hellotracks
Step 7: In Hellotracks, go to Settings and select API & Integrations.

Step 8: Under Single Sign-On (SSO), click Set up SSO configuration.

Step 9: Fill in the needed details.
- Under Select identity provider, choose Azure AD.

- In Enter tenant ID and Enter client ID, enter the Directory (tenant) ID and the Application (client) ID from the app's overview page in Azure.

- In Client secret (remains hidden for safety reasons), enter the secret Value you copied in Step 5.

Step 10: Click Save.

Step 11: Under Single Sign-On (SSO), a Notes box now shows Link to SSO login page. Click the copy button next to it and send the link to your users.
The link opens your Microsoft login page directly. Users who don't have a Hellotracks account yet need this link for their first login: Hellotracks then creates their account with the Worker role, and their Microsoft email becomes their username.
All done. Now users are ready to use Microsoft Entra ID (Azure AD) to log in to Hellotracks. ✅
For users to log in via SSO:
FIRST LOGIN (NEW USERS)
Open the Link to SSO login page that your admin sent you and log in with your Microsoft account. This works in any browser, also on your phone. Hellotracks creates your account, with your Microsoft email as username. After that, you can log in on the web and in the app as described below.
WEB
Step 1: Go to https://live.hellotracks.com/login and click the Single Sign-On (SSO) button at the bottom.

Step 2: In Username or email, enter your Hellotracks username and click Log in. Your Microsoft login page opens.

MOBILE
Step 1: Open the Hellotracks app and tap Log in.
Step 2: In Email or username, enter your Hellotracks username and tap Continue.
Step 3: Tap Log in with single sign-on. Your Microsoft login page opens.
The Log in with single sign-on button only appears for accounts of a company with SSO set up. Logging in with a password stays possible on the same screen.
To log phones in automatically through Intune, see How to Configure MDM (Intune) and Auto-Login with Microsoft Enterprise SSO. To create and remove users from Entra, see How to Manage User Lifecycle with Microsoft Entra (SCIM).