Articles on: Integrations

How to connect LeadTruffle and ServiceTitan

How to Connect ServiceTitan to LeadTruffle


How to connect ServiceTitan to LeadTruffle


📝 This guide walks you through creating a private app in ServiceTitan and connecting it to LeadTruffle for CRM sync, AI booking, and availability checks.



Table of contents




Prerequisites


  • Your ServiceTitan account must be on The Works plan
  • You need admin access to your ServiceTitan account
  • You need access to the ServiceTitan Developer Portal


If you don't already have access to the Developer Portal, you'll need to sign in with your ServiceTitan admin credentials. If you see a "User doesn't have access" error, try using an administrator account.


Are ServiceTitan and LeadTruffle already connected and you're looking to active AI Booking in ServiceTitan? Follow this guide: How to turn set up AI Booking for ServiceTitan in LeadTruffle.



Step 1: Create a private app in ServiceTitan Developer Portal


  1. Go to developer.servicetitan.io/signin
  2. Under ServiceTitan Customers, click Sign In as Production Environment User



  1. Sign in with your ServiceTitan admin credentials
  2. Click My Apps at the top of the page
  3. Click Register New App
  4. Prompt appears: "Who will be accessing the API endpoints/webhooks?"
  • Select "Our organization"
  • Check the box: "I confirm this app is being hosted and maintained by my organization"
  • Click Continue
  1. Enter the following details:
  • App Name — enter "Lead Follow Up"
  • Organization Name — your company name (e.g. Bryan's HVAC)
  • Organization/App Website — your company website (https://bryanshvac.com)
  • Email Address — your email (bryan@bryanshvac.com)
  • Description — "Lead response automation for ServiceTitan. Helping us book more leads into appointments so we can grow our business."
  1. Under API Scopes, enable the following permissions:
  • CRM — All Read & Write except Leads
  • Settings — Read "Employees"


Scope

Read

Write

CRM — Booking Provider Tags

✅

✅

CRM — Bookings

✅

✅

CRM — Customers

✅

✅

CRM — Leads

❌

❌

CRM — Locations

✅

✅

CRM — Tags

✅

✅

Settings — Employees

✅

❌


  1. Under Client Credentials Management, select "I, the app developer, will configure the credentials on behalf of each tenant"
  2. Click Create App
  3. Your App Key will be generated — copy it and save it somewhere secure


Copy your App Key now. You'll need it in Step 5.


*For more details, see ServiceTitan's official guide: Create an App



Step 2: Create a booking provider tag


A Booking Provider Tag tells ServiceTitan where a booking came from. You need to create one for LeadTruffle so it can create bookings in your account.


  1. Log in to your ServiceTitan account at go.servicetitan.com
  2. Go to **Settings → Integrations → **Booking Provider Tags
  3. Click Add Tag
  4. Enter "LeadTruffle" as the tag name
  5. Add a description if you'd like (optional)
  6. Click Save




This tag is required for LeadTruffle to create bookings in ServiceTitan. You'll select it inside LeadTruffle in Step 5.


For more details on how booking providers work, see ServiceTitan's CRM API documentation.



Step 3: Connect the app in your ServiceTitan account


  1. Still in ServiceTitan, go to **Settings → Integrations → **API Application Access
  2. Click Connect New App
  3. Find and select the app you just created (e.g. "LeadTruffle")
  4. Review the API scopes — these are the permissions you selected in Step 1
  5. Under Restriction by Booking Provider, choose No Restriction
  6. Click Allow Access




Choose "No Restriction" here — you'll select the specific LeadTruffle booking provider inside LeadTruffle in Step 5.


*For more details, see ServiceTitan's official guide: Client ID & Secret



Step 4: Generate your client ID and client secret


If you selected "I, the app developer, will configure the credentials" in Step 1:


  1. Go back to developer.servicetitan.io
  2. Click My Apps
  3. Click App Connections for your LeadTruffle app
  4. Find your tenant and click Generate under Client Secret
  5. Copy the Client ID and Client Secret — save both somewhere secure


If you're generating credentials from ServiceTitan directly:


  1. In ServiceTitan, go to Settings → Integrations → API Application Access
  2. Select the LeadTruffle app from your connected apps
  3. Your Client ID will be displayed on the Application Details screen
  4. Click Generate next to Client Secret, then click Yes, Continue
  5. Copy the Client ID and Client Secret


You can only see the Client Secret once. If you lose it, you'll need to generate a new one. You can have up to two active secrets per app.



Step 5: Enter your credentials in LeadTruffle


  1. In LeadTruffle, go to ServiceTitan Settings
  2. On the Basic Settings tab, you'll see the Credentials section



  1. Select Provider Scoped
  2. Fill in the following fields:


Field

Where to find it

Tenant ID

ServiceTitan → Settings → Integrations → API Application Access

Environment

Select Production

App Key

Copied from Step 1 when you created the app

Client ID

Copied from Step 4

Client Secret

Copied from Step 4

Booking Access Mode

Select Provider scoped


  1. Under Booking Provider, click Detect Booking Providers
  2. LeadTruffle will search your ServiceTitan account and show the available providers
  3. Select LeadTruffle Booking from the dropdown (this is the tag you created in Step 2)


  1. Make sure "Keep this integration active after saving" is checked
  2. Click Save



Troubleshooting


I don't see my app when connecting in ServiceTitan

Make sure you added your tenant ID to the app in the Developer Portal. Go to My Apps → edit your app → check that your tenant ID is listed.


"User doesn't have access to Developer Portal" error

You need to sign in with an admin account. If your account doesn't have admin access, ask your ServiceTitan admin to complete these steps.


"Not Connected Yet" status in Developer Portal

The tenant admin hasn't connected to the app yet. Complete Step 3 first, then return to generate credentials.


Client Secret was lost or not copied

Go back to the Developer Portal → My Apps → App Connections and generate a new one. You can have up to two active secrets per app.


LeadTruffle Booking doesn't appear when I click Detect Booking Providers

Make sure you created the Booking Provider Tag in Step 2. Go to Settings → Integrations → Booking Provider Tags in ServiceTitan and confirm the tag exists.


What's the difference between Tenant Scoped and Provider Scoped?

Provider Scoped connects LeadTruffle to a specific Booking Provider Tag so it can create bookings in ServiceTitan. This is the recommended setup. Tenant Scoped is only used for reading booking data and does not support creating new bookings.



Summary


You've created a private app in the ServiceTitan Developer Portal, added a LeadTruffle booking provider tag, connected the app in your ServiceTitan account, generated API credentials, and entered them into LeadTruffle. Your ServiceTitan integration is now active for CRM sync, AI booking, and availability checks.



Need help? Contact us at support@leadtruffle.com or message the team via the Intercom chat on this article or in-app.

Updated on: 19/05/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!