--- title: "Set up Azure Active Directory for ServiceTitan login" slug: "set-up-azure-active-directory-for-servicetitan-login" updated: 2026-10-15T01:31:22Z published: 2026-10-15T01:31:22Z canonical: "help.servicetitan.com/set-up-azure-active-directory-for-servicetitan-login" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.servicetitan.com/llms.txt > Use this file to discover all available pages before exploring further. # Set up Azure Active Directory for ServiceTitan login ## Overview Enable single sign-on (SSO) to ServiceTitan using Microsoft Azure Active Directory (AAD). This integration allows users to securely access all ServiceTitan products with one set of credentials. --- ### #### Feature configuration - Account configuration is required to use this feature. Please contact your Customer Success Manager (CSM) for details. ## Step 1: Add your Directory Tenant ID 1. Go to [portal.azure.com](http://portal.azure.com) and log in with your AAD username and password. > [!NOTE] > **Note:** If you have login issues, contact your Azure administrator. 2. In your Azure Portal, select **Azure Active Directory > Properties**. 3. Copy the Tenant ID. ![The Tenant ID section of the Properties screen in Azure.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/set-up-azure-active-directory-for-servicetitan-login-image-1p0vxclw.png?sv=2026-02-06&spr=https&st=2026-10-31T02%3A38%3A34Z&se=2026-10-31T03%3A38%3A34Z&sr=c&sp=r&sig=eGmLkH%2BSatqUxd3YBofQ0UiJwP5VoD%2F45E4WAv%2BqzjU%3D) 4. Send your Tenant ID to your CSM so that they configure it on the ServiceTitan side. 5. Contact your Microsoft Azure Administrator to grant permissions within Azure. ## Step 2: Create users and groups You have two options for connecting users to ServiceTitan via Azure: - **Option 1: Create groups:** In Azure Active Directory (AAD), create groups that map to user roles in ServiceTitan. > [!NOTE] > **Note:** ServiceTitan cannot create new users unless these groups are set up. - **Option 2: Link existing users:** To associate existing ServiceTitan users with their AAD identities, enter each user's Azure AD Object ID in ServiceTitan. **Option 1** You need to create groups in Azure Active Directory. They are called roles in ServiceTitan. > [!NOTE] > **Note:** Without this action ServiceTitan can't create new users. 1. In Azure Active Directory, click **Groups**. 2. Click **New Group**. ![A cursor clicking New group under All groups in Azure.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/set-up-azure-active-directory-for-servicetitan-login-image-s56711no.png?sv=2026-02-06&spr=https&st=2026-10-31T02%3A38%3A34Z&se=2026-10-31T03%3A38%3A34Z&sr=c&sp=r&sig=eGmLkH%2BSatqUxd3YBofQ0UiJwP5VoD%2F45E4WAv%2BqzjU%3D) 3. In the window that opens, fill out the fields. 4. Click **Create**. ![The New Group screen with filled in fields.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/set-up-azure-active-directory-for-servicetitan-login-image-bcfj6pz4.png?sv=2026-02-06&spr=https&st=2026-10-31T02%3A38%3A34Z&se=2026-10-31T03%3A38%3A34Z&sr=c&sp=r&sig=eGmLkH%2BSatqUxd3YBofQ0UiJwP5VoD%2F45E4WAv%2BqzjU%3D) **Option 2** To link already created ServiceTitan users with Active Directory users, you need to enter the Object ID for each user. 1. In Azure Active Directory, go to **Users >** **All Users**. 2. Select the necessary user. ![A cursor clicking a user's name in Azure.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/set-up-azure-active-directory-for-servicetitan-login-image-3krz686z.png?sv=2026-02-06&spr=https&st=2026-10-31T02%3A38%3A34Z&se=2026-10-31T03%3A38%3A34Z&sr=c&sp=r&sig=eGmLkH%2BSatqUxd3YBofQ0UiJwP5VoD%2F45E4WAv%2BqzjU%3D) 3. Copy the Object ID. ![The Object ID field for a user in Azure.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/set-up-azure-active-directory-for-servicetitan-login-image-mh1mrgzc.png?sv=2026-02-06&spr=https&st=2026-10-31T02%3A38%3A34Z&se=2026-10-31T03%3A38%3A34Z&sr=c&sp=r&sig=eGmLkH%2BSatqUxd3YBofQ0UiJwP5VoD%2F45E4WAv%2BqzjU%3D) 4. Provide the Object ID to your CSM to link the user. ## Step 3: Log in with Azure Active Directory When you set up your AAD, your employees can log in to ServiceTitan with AAD. 1. Go to [https://go.servicetitan.com/AAD](https://go.servicetitan.com/AAD). ![The Login via Active Directory screen for ServiceTitan.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/set-up-azure-active-directory-for-servicetitan-login-image-ghrl7f1x.png?sv=2026-02-06&spr=https&st=2026-10-31T02%3A38%3A34Z&se=2026-10-31T03%3A38%3A34Z&sr=c&sp=r&sig=eGmLkH%2BSatqUxd3YBofQ0UiJwP5VoD%2F45E4WAv%2BqzjU%3D) 2. Click **Login via Active Directory**. You are redirected to the *Microsoft Azure Login* screen. 3. Enter your credentials and you are redirected to ServiceTitan. > [!NOTE] > **Note:** Use your Active Azure Directory credentials. > [!TIP] > **Tip:** If you don't have a ServiceTitan user connected to Active Directory, then you are redirected to the *New User* screen. ![The Create a ServiceTitan login screen.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/set-up-azure-active-directory-for-servicetitan-login-image-7o460n68.png?sv=2026-02-06&spr=https&st=2026-10-31T02%3A38%3A34Z&se=2026-10-31T03%3A38%3A34Z&sr=c&sp=r&sig=eGmLkH%2BSatqUxd3YBofQ0UiJwP5VoD%2F45E4WAv%2BqzjU%3D) 4. Fill out the necessary fields and click **Create User.** You are redirected to ServiceTitan. ## Step 4: Enable multi-tenant AAD access Multi-tenant AAD access allows you to use several tenants in ServiceTitan using one Azure Active Directory. > [!NOTE] > **Note:** For security reasons, automatic user creation is disabled in ServiceTitan for multi-tenant AAD cases. ## Add a claim to your AAD tokens AAD administrators need to add an additional claim to access token and ID token of the user's Azure Active Directory. It is the user identifier for ServiceTitan. The claim should have a one to one relationship with ServiceTitan and should have the following parameters: - **Name**: st_tenant_id - **Syntax**: Unicode string - **Value**: From 1 to 9223372036854775807 - **Maximum length**: 19 digits ## Step 5: Link multi-tenant AAD users to ServiceTitan You must create ServiceTitan users before linking them to the respective AAD users. There are two options for doing it: **Option 1: Add users in ServiceTitan** Go to **Settings > People > Employees > Add**. For more on how to add an employee, see [Add and manage office employee profiles.](/construction/docs/add-and-manage-office-employee-profiles) **Option 2: Use ServiceTitan public API** 1. Use the [ServiceTitan public APIs](https://developer.servicetitan.io/api-details/#api=tenant-settings-v2&operation=Employees_Create) to create users. 2. When you create a new employee, add their AAD user object ID to ServiceTitan. To find the Object ID: 1. Go to [portal.azure.com](http://portal.azure.com). 2. Sign in with your Azure username and password. 3. Select Azure Active Directory. 4. Click **Users**. 5. Select the user. 6. Click **Properties**. 7. Provide the Object ID to your CSM. ## Step 6: Verify multi-tenant login 1. Go to [https://go.servicetitan.com/auth/login/aad](https://go.servicetitan.com/auth/login/aad). 2. Click **Login via Active Directory**. ![The Sign in to ServiceTitan screen.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/set-up-azure-active-directory-for-servicetitan-login-image-os4gerk5.png?sv=2026-02-06&spr=https&st=2026-10-31T02%3A38%3A34Z&se=2026-10-31T03%3A38%3A34Z&sr=c&sp=r&sig=eGmLkH%2BSatqUxd3YBofQ0UiJwP5VoD%2F45E4WAv%2BqzjU%3D) 3. Sign in with your AAD credentials. ![The Enter password screen.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/set-up-azure-active-directory-for-servicetitan-login-image-kuys4w4g.png?sv=2026-02-06&spr=https&st=2026-10-31T02%3A38%3A34Z&se=2026-10-31T03%3A38%3A34Z&sr=c&sp=r&sig=eGmLkH%2BSatqUxd3YBofQ0UiJwP5VoD%2F45E4WAv%2BqzjU%3D) You are redirected to ServiceTitan upon successful authentication.