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:
- Customer name
- Email address and phone number
- Full project address, when street, city, state, and ZIP code are all available
- The name of the NZ Leads source the lead came from
- Lead description and project details
- Requested job names and additional information
- Team memos from the lead record
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.
- When on - ServiceTitan gets the lead only once the AI decides in the conversation that the lead is interested.
- It works only where the AI holds the conversation: AI Assistant with Short conversation or Long conversation in Conversation Setup. A source without that sends nothing to this integration while the option is on.
- It applies to every place that uses this integration.
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
- For one source - On that source’s Integrations tab, switch ServiceTitan off. If the tab shows Business Settings Active, switch on Customize for Location first. You can also untick the source under Where it’s used in the ServiceTitan window. Other sources keep sending.
- Everywhere - Turn off Enabled on the card, or click Delete integration in the ServiceTitan window. Every place that used it stops sending.
Troubleshooting
- Credentials fail to save: confirm all four fields are present and belong to the same ServiceTitan API application and tenant.
- Permission or authorization error: ask the ServiceTitan admin to confirm the application has
tn.crm.leads:randtn.crm.leads:w. - Integration is connected but no lead appears: confirm Enabled is on and that ServiceTitan is on for the source on its Integrations tab. Errors from the last 7 days mark the integration as Has errors on the Integrations page: open it and click the warning icon at the top of its settings to read them.
- Address is missing in ServiceTitan: NZ Leads only sends the address when street, city, state, and ZIP code are all available.
- A later phone number did not create another lead: the integration intentionally creates one ServiceTitan lead form per NZ Leads lead.
Questions about the ServiceTitan integration? Email support@nzleads.com.