Service Titan Knowledge Base Leads IntegrationLast updated on 05/23/2023

Use this Leads Integration to manage system-generated leads you receive directly from in ServiceTitan. This helps to automate the conversion of leads you receive to jobs.

Things to know

  • You must be a dealer in order to take advantage of this integration. If you don’t have any solutions installed in your customer base, you can visit the page on ServiceTitan’s partner marketplace and click ‘learn more’ to get started.

  • Setup is required to integrate your leads from into ServiceTitan.

  • Only users with Administrator or Owner roles in ServiceTitan can accept the data agreement to set up the integration.

  • If a Standard Job Type has multiple Custom Job types and/or Business Units mappings, the Job Type and business units will not pre-populate in the lead.

  • Only a pre-set list of high-priority alert types is sent from into ServiceTitan at this time. For each available lead type, see Available lead types.

Available lead types

You can see actionable alert types and their associated Standard Job Types in ServiceTitan in the following table. For more information on Standard Job Types, see Map Job Types.

Alert Type in

Standard Job Type in ServiceTitan

Water Detected

Leak Detected

Poor Heating Performance

Repair Heating System

Poor Cooling Performance

Repair AC

Coil Freeze Warning

Repair AC

Service Request-Normal

AC Maintenance

Service Request-Tune Up

HVAC Maintenance

Service Request-Emergency

Repair HVAC

Note: Not all leads are passed through; only those which should lead to an actionable opportunity.

Set up the Integration

As a dealer, you need to complete the following steps to ensure the integration setup for all accounts or locations with your ServiceTitan account.

  • Step 1: Accept the authorization form

  • Step 2: Authorize the integration

  • Step 3: Map job types to business units

  • Step 4: Map job types in Marketing Integrations

Step 1: Accept the authorization form

You must review and accept the terms of the Authorization Form in ServiceTitan. With integration, providers can view the Authorization Form. Note: Only administrators and owners can accept the authorization form.

To accept the authorization form:

  1. Go to the navigation bar and click Settings settings-icon

  2. In the side panel, click Integrations > Marketing Integrations.

  3. Click Configure next to the integration.

  4. On the Data Agreement page that opens, read through the authorization form. When you’re finished, select that you’ve read the terms and click Agree.

    Tip: Click Download PDF to download the agreement for future reference. Another way to view the agreement in the future is to click More More_icon from the integration page and select View Agreement.

Step 2: Authorize the integration

After you accept the Authorization Form, connect your account(s) to ServiceTitan. You’re prompted to log in and permit the connection from the integration page.

To authorize the integration:

  1. Click Sign in with

  2. In the Partner Portal login window, enter the information to log in.

  3. When you’re finished, click Continue.

  4. Go back to ServiceTitan to finish pairing. Note: After you connect your account with, you will receive information from about the accounts and profiles included in the integration.

  5. After your account is connected, you can assign business units (BUs) to this account:

    • If you have profiles set up with, select BUs for each profile. This helps us communicate efficiently with to receive and post the correct leads on your booking screen.

    • If you don’t have profiles set up or you have more than one account, select the BUs you want to associate with the account.

  6. (Optional) If you need to connect multiple accounts to your ServiceTitan account, click + Add Account to add another account. This will prompt you to sign in to the portal again using a different set of credentials.

  7. When you’re finished, click Save. This takes you to the next step of mapping job types.

Step 3: Map job types to business units

After authorizing the integration, configure the integration by setting the default job type mapping. This helps you save time when you begin using the integration. Additionally, mapping job types helps us receive and post the leads correctly for you on the booking screen and dispatch.

Under each vertical that applies to your business (HVAC, Plumbing, Electrical, and more), map your job types to ServiceTitan standard job types. Then, apply the BUs that service these job types.

After this step is completed, the integration launches and you begin receiving leads from your account.

Note: You only need to do this once and the job type mapping will be leveraged for future integrations as well. If you have already completed mapping your job types to the standard job types, you will not need to do this again. For example, if you are already using the Google Local Services Integration, you don’t need to complete this step as you have already completed it.

To map job types to business units:

  1. Go to the navigation bar and click Settings settings-icon .

  2. In the side panel, click Integrations > Marketing Integrations.

  3. Click Configure next to the integration. The integration page opens.

  4. Click Job Types. The Job Types window opens.

  5. Click Go To Job Type Mapping to go and map job types.

  6. On the Job Type Mapping page that opens, map the Standard Job Types to your job types and business units. For more information, see Map Job Types.

  7. When you’re finished, click Save Changes.

  8. Click Return to Integration Setup. On the integration page, you can find the job types and the BUs that are part of the leads integration.

  9. Review the job type mapping.

  10. When you’re finished, click Finish to complete the integration setup.

Step 4: Map job types in Marketing Integrations

To enable or disable job types configured in global Job Type Mapping:

  1. Go to the navigation bar and click Settings > Integrations > Marketing Integrations.

  2. Click Configure next to the integration.

  3. On the integration page, click Job Types.

  4. Select the trade you want to disable any of its standard job types and turn off the Enabled toggle if you want to disable the job type. Note: The Enabled toggle is active by default.

  5. When you’re finished, click Save. Your integration is set up and ready to receive booking requests in ServiceTitan.

Note: You can disable the integration temporarily by turning off the Enabled toggle.

Tip: You can resume configuration at any stage by clicking Finish Editing next to the integration.

Edit integration with

  1. Go to the navigation bar and click Settings settings-icon . In the side panel, click Integrations > Marketing Integrations.

  2. Click Edit next to the integration you want to update.

  3. Edit your content as needed. When you’re finished, click Save.

Book a job from a lead

You can book a job for a lead you received from through the Calls screen:

  1. Go to the navigation bar and click Calls, then click Bookings. The Bookings window opens. Note: Depending on your account setup type the Calls tab is also called the Job Booking tab.

  2. Select the lead you want to book. Note: On the lead booking card you can view the customer’s contact information, lead submitted and scheduled dates, extra details provided by, and the lead’s integration and logo.

  3. Review lead details and click Accept. Note: If the customer listed in the lead card does not automatically match with a customer in your records, this can be because the customer’s information such as address is not an exact match between ServiceTitan and To match the lead card with the existing customer in your ServiceTitan records, simply search for the customer in the lead card.

  4. (Optional) If you have an in-house Smart Home Manager or another office resource that manages all Smart Maintenance-related leads, you can instruct your CSRs to route leads from to the Follow Ups tab for further review. To do this see Use customer leads. Tip: Reach out to the customer. leads are system-generated alerts and not bookings. It is considered best practice to use the lead as an opportunity to reach out to the customer, let them know you were alerted of an issue, and convert the lead to a job.

  5. Enter job details to complete booking the job. Note: The marketing campaign “” is selected by default.


Available lead types At this time, the available lead types for the integration are as shown in the section Available lead types and frequencies. Currently, only Critical and Urgent leads are available. Other lead types including all Watching insights may be viewed in the Partner Dashboard.

Want to learn more?

Important note: Some features may not be currently included in your account and additional configuration may be required. Please contact technical support for details.

Disclaimer: Information provided in this article is for informational purposes only and it should not be construed to be legal advice. Information provided in this article may also not constitute the most up-to-date legal or other information. You should not act or refrain from acting on the basis of any information in this article to meet any compliance requirements without seeking independent legal or other professional advice.