ServiceTitan Integration

The ServiceTitan integration sends new NZ Leads leads into ServiceTitan CRM as lead forms. It carries the customer details and job context your team needs, while preventing the same NZ Leads lead from being submitted twice.

ℹ️

You set ServiceTitan up once and then choose which businesses and sources send leads to it. Add it from Settings → Integrations in the menu, or from a source’s Messaging Settings → Integrations tab. In the Add integration list it’s ServiceTitan, under CRM and field service. Voice agents can’t use it.

ℹ️

This page covers CRM lead sync. The AI can also create ServiceTitan booking requests, both in text conversations and on voice-agent calls. That’s a separate setting with its own credentials: choose ServiceTitan under Appointment Scheduling in a source’s Conversation Setup, or in a voice agent’s Appointments section (see Voice Agent Scheduling Integrations).

What the integration sends

When the available information is present, the ServiceTitan lead form includes:

The address is only attached when all required address fields are available. This avoids submitting a partial address that ServiceTitan cannot use reliably.

Connect ServiceTitan

Get the Tenant ID

Ask a ServiceTitan admin to open Settings > Integrations > API Application Access and copy the Tenant ID.

Get the application credentials

In the ServiceTitan Developer Portal, open the API application for this integration. Copy the Application Key into the App Key field, copy the Client ID, and generate a Client Secret.

Allow CRM Leads access

Ask your ServiceTitan admin or support contact to give the application CRM Leads read and write access. The required scopes are tn.crm.leads:r and tn.crm.leads:w.

Add ServiceTitan in NZ Leads

Go to Settings → Integrations → Add integration → ServiceTitan. The ServiceTitan window opens.

You can also start from a source: open the source → Messaging Settings → Integrations tab → Add integration → Create new → ServiceTitan. If the tab shows Business Settings Active, switch on Customize for Location first. To reuse a ServiceTitan integration your account already has, pick it on the Use existing tab instead.

Save the credentials

Under Connect ServiceTitan, enter the Client ID, Client Secret, App Key, and Tenant ID, then click Save credentials. NZ Leads checks the credentials with ServiceTitan before saving them.

Turn on Enabled

The credentials are saved with the integration switched off. Turn on Enabled on the card.

Choose where it’s used

Under Where it’s used, tick the businesses, source types, and sources that should send leads to ServiceTitan. Ticking a business covers all its sources, including sources added later. If you added ServiceTitan from a source’s tab, that source is already ticked, unless it uses another ServiceTitan integration.

💡

The ServiceTitan API application must have access to CRM Leads. This connector submits a lead form and does not create a ServiceTitan contact directly.

When a lead is submitted

ServiceTitan gets the lead when it arrives, when the customer shares a phone number or email (if CRMs is ticked under Trigger integrations: in the source’s Contact Info settings), or when a voice-agent call with the lead ends. The first successful submission stores the ServiceTitan lead ID on the NZ Leads lead. Later events skip another submission, preventing duplicate ServiceTitan lead forms.

Options

Enabled

Turns this ServiceTitan integration on or off everywhere it’s used. To stop sending for one source only, switch ServiceTitan off on that source’s Integrations tab instead.

Notify this integration only after the AI determines the lead is interested

Default: off. Turning it on asks you to confirm: Let AI decide which leads are sent? → Enable.

Updating or disconnecting credentials

Open the ServiceTitan window from the Integrations page. Under Update ServiceTitan Credentials, the Client ID, App Key, and Tenant ID are filled in. The Client Secret is not displayed again, so enter it whenever you save, then click Save credentials. Saving replaces the stored credentials: Enabled turns off and Notify this integration only after the AI determines the lead is interested is cleared. Close the window, open it again, and turn them back on.

To disconnect, click the panel that shows your Tenant ID to expand it, click the trash icon, and confirm with Yes. The credentials are cleared and the integration sends nothing until you save new ones and turn on Enabled. To remove the integration itself, click Delete integration in the window.

Turning ServiceTitan off

Troubleshooting


Questions about the ServiceTitan integration? Email support@nzleads.com.

Get Started