brand logo
Skip to main content

Partner Leads Integrations

Overview

Use Leads Integration to set up and manage booking requests you receive directly from your lead sources, such as online booking forms and call screens in ServiceTitan. This helps you convert more leads to jobs, all in one place.


Who uses this feature

  • Administrators, Customer Service Representatives (CSRs), Marketing Managers, Operations Managers, and Project Managers.

Feature configuration

  • Account configuration is required to use this feature. Please contact Technical Support for details.

Benefits

  • Manage booking requests efficiently—With an integrated solution, you can manage all leads for sales, service, and installation requests from the ServiceTitan booking screen, helping you convert more leads to jobs.

  • Lower costs related to manual data entry—Keep the team fast and lean by spending less staff hours on manually copying over leads and fixing human errors. Leads show up in ServeTitan automatically!

  • Get full control over the integration—Set up your integration, view agreements, and edit your integration and job types at any time.

Things to know

  • Set up is required to enable Leads Integration.

  • Only users with Admin or Owner roles are able to accept the data agreement.

  • If the customer didn't mention any preferred date for the contractor visit, the contractor needs to contact them to schedule a date/time.

  • If a Standard Job Type has multiple Custom Job types and/or Business Units mappings, the Job Type and business units don't pre-populate on the job booking screen.

Integration with a Leads Source

Before you can begin receiving leads from available leads sources in ServiceTitan, complete these setup steps to configure each integration with your ServiceTitan account.

  • Step 1: Accept the authorization form

  • Step 2: Authorize your 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 each 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 Settings A simple icon representing a settings gear. > Integrations > Marketing Integrations.

  2. Click Configure next to the integration you want to accept the authorization form for. Screenshot of the Leads cards UI showing two integration cards inside a bordered panel — left card with Edit button and toggle, right card with an OID avatar and a blue Configure button being pointed at by a hand cursor icon

  3. When the Authorization Form page opens, read through the authorization form. When you're finished, select that you've read and click Agree. Authorization Form modal showing a PDF viewer with the ServiceTitan API Terms document. The modal includes a scrollbar at right, a checked checkbox confirming agreement near the bottom left, a Download PDF button, and Cancel and blue Agree buttons at the bottom right.

Tip: Click Download PDF to download the agreement for future reference. Another way to view the agreement in the future is to click More A simple icon in the shape of three dots, lined up vertically. from the integration screen and select View Agreement.

Step 2: Authorize your integration

After you accept the Authorization Form, connect your lead source account to ServiceTitan. You're prompted to log in and permit the connection from the integration screen.

To authorize your integration:

  1. Click Sign in with [lead source name]. The lead source account login window opens. Modal dialog titled Authorization showing an OID connection screenshot with a Sign in with OID blue button and a cursor hand clicking the button; blurred OID and description at the top of the modal.

  2. Log in to your lead source account.

  3. When you're finished, click Continue.

  4. Go back to ServiceTitan to finish pairing.

    Note: Once you connect your account with your lead source, you will receive information from your lead source 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, select BUs for each profile. This helps us communicate efficiently with the lead source to receive and post the correct leads on your booking screen. Screenshot of an account setup panel titled Plumbing, HVAC & Electric Pros showing a two-column grid with column headers Profile and Business Unit(s). Rows visible in the panel read Plumbing Install, Plumbing Maintanance, and Plumbing Sales & Services. On the right a multi-select dropdown is open showing 2 selected and a scrollable list of options with checkboxes including Plumbing - Install, Plumbing - Service, Plumbing - Maintenance, Plumbing - Sales, Electrical - Install, Electrical - Service, Electrical - Maintenance, Electrical - Sales, HVAC - Install. A blue-outlined button labeled + Add Account is visible below the panel. At the lower-left of the screenshot a Job Types card shows two metrics: ACTIVE TRADES with value 1 and JOB TYPES MAPPED with value 1.

    • 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. Modal dialog titled Plumbing, HVAC & Electric Pros showing a Profile row Plumbing Install with Business Unit(s) chips (Plumbing - Install, Plumbing - Service), a + Add Account button with a pointing-hand cursor, and Cancel and Save buttons at the bottom right

  6. When you're finished, click Save. This takes you to step 3 to map 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 will help you save time once you begin using the integration. Additionally, mapping job types helps us receive and post the leads correctly for you on the booking screen.

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

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

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 will not need to complete this step as you have already completed it.

To map job types to business units:

  1. Go Settings A simple icon representing a settings gear. > Integrations > Marketing Integrations.

  2. Click Configure next to the integration you want to work with. The integration screen opens.

  3. Click Job Types. The Job Types window opens.

  4. Click Go To Job Type Mapping to go and map job types. Screenshot titled Job Types showing an illustration of buildings and icons. Large heading text reads Oops! It looks like you need to map your job types. Below is explanatory copy about configuring the booking integration and setting default job type mapping so ServiceTitan can calculate real-time availability, a purple informational box that says This process should take 5-10 minutes. Once you're done, you'll be redirected back to this page to finish the integration setup and have everything set for future integrations!, and a blue button labeled Go To Job Type Mapping → with a hand cursor pointing at it.

  5. On the Job Type Mapping screen, if this is your first time integrating trades, click Select Trades. The Trades List window opens. Full Job Type Mapping screen screenshot showing a left navigation column (with Job Type Mapping highlighted) and the main content area with a Trades Not Selected message and illustration. A blue Select Trades button is shown near the bottom with a hand cursor pointing at it.

  6. Select the trades for your business and click Confirm. Hand cursor pointing at the Plumbing checkbox inside the Select Trades modal

The selected trades appear on the Job type mapping page.

  1. Click the trade which you want to map. Screenshot of a Job Type Mapping panel. Header reads Job Type Mapping with subtext Map your job types and business units to the standard job types for each of the trades that fit your business. Learn more. A Manage Trades 2 button appears at the top-right. Two trade rows are shown: Plumbing with a 1 Mapped badge, and HVAC with a 4 Mapped badge. A pointing-hand cursor icon is over the HVAC row.

  2. For each Standard Job Type, select Your Job Types and Business Unit(s) from the dropdown. Standard Job Types are what appear for your customers to book through each of these integrations. Mapping your job types helps group them to standard job types in each integration. Mapping your business units to standard job types identifies which technicians should be calculated in available capacity.

    Note: You can choose as many custom job types as you need in addition to more than one BU.

    Screenshot of the Job Type Mapping panel — a bordered UI card titled Job Type Mapping with a subtitle. Shows two trade rows: Plumbing with a badge 1 Mapped and HVAC with a badge 4 Mapped. Below HVAC is a table header row Standard Job Types | Your Job Types (info) | Business Unit(s) (info). Two visible table rows: AC maintenance with Your Job Types tags Clogged Toilet, Estimate and Business Unit tag Plumbing - Sales; and Clean ducts & vents with Your Job Types tag Fixture Install and Business Unit tag Plumbing - Maintenance.

  3. When you're finished, click Save Changes. A window confirming the successful job type mapping appears. Make sure that all selected trades have Job types and BUs mapped before saving.

    • (Optional) You can add and remove trades from your list, but you should keep at least one trade. To remove trades, unselect the trades vertical in the list, and confirm the changes. Modal titled Select Trades (1) showing a yellow warning box with a warning icon and the text Warning Removing this vertical may affect integrations that use job type mapping., a Restore Selection button, a search field with placeholder Search, a COMMON section with checkboxes including HVAC, Plumbing, and Electrical, and a large hand cursor over a checkbox.

    Note: You can also remove the Business Units and Job types previously selected by clicking on the "x" icon next to the Job type or Business unit names.

  4. When you're finished, click Save Changes. A confirmation pop-up opens.

  5. Click Return to Integration Setup. In the integration screen that opens, you can find the job types and the BUs that are part of the leads integration.

  6. Review the job type mapping. 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 Settings A simple icon representing a settings gear. > Integrations > Marketing Integrations.

  2. Click Configure next to the integration you want to work with. Panel titled LEADS showing two integration cards side by side. Left card shows an Edit button and an enabled toggle; right card shows an avatar and a blue Configure button with a pointing-hand cursor icon clicking it; card details are blurred

  3. In the integration screen that opens, click Job Types.

  4. Select the trade you want to disable any of its standard job types, and toggle Enabled if you want to disable the job type.

    Job types for plumbing integration with warnings for incomplete mappings displayed.

    Note: Enabled toggle is active by default.

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

    Note: You can also disable the lead source integration temporarily by toggling Enabled.

    Integration settings card titled Global Plumbing Service showing a green toggle labeled Enabled at top right. The card contains two sections: Authorization with ACCOUNTS CONNECTED and the number 5, and Job Types with ACTIVE TRADES = 1 and JOB TYPES MAPPED = 1.

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

     Alert card inside a bordered box showing a penguin icon on the left, a hand-cursor clicking a Finish Editing button at top right, and the text OID - Wrong URL with subtext OID - Wrong URL Description.

Real-Time Availability (RTA)

ServiceTitan shares your real-time availability with the lead source website so as to provide an accurate booking experience to potential customers. The real-time availability calculation is based on your capacity. This feature is enabled by default if your lead source provides real-time availability on their website.

Edit integration with Leads Sources

  1. Go to Settings A simple icon representing a settings gear. > Integrations > Marketing Integrations.

  2. Click Edit next to the integration you want to update. Integration card showing a circular penguin/logo on the left, the text OID and OID - . Description below it, and on the right an Edit button with a pointing-hand cursor graphic and a green toggle switch.

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

Book a job from a lead

To book a job for a lead you've received:

  1. Go to the navigation bar and click Calls, then click Bookings. The Bookings window opens.

  2. Select the lead you want to book.

    List of bookings with details for two individuals and their scheduled times.

    Note: On the booking card you can view the customer's contact information, leads submitted and scheduled dates, extra details provided by the unique partner, and the leads' integration and logo.

  3. Review lead details and click Accept.

  4. Enter any job details and select the marketing campaign to complete booking the job.