Housecall Pro

The Housecall Pro integration creates customers in your Housecall Pro account for every lead NZ Leads handles, and updates each customer as the conversation goes on.

ℹ️

You set Housecall Pro up once and then choose where it’s used: which businesses, sources, and voice agents 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 Housecall Pro, under CRM and field service.

What gets synced

Every customer pushed into Housecall Pro includes:

Connecting Housecall Pro

Add Housecall Pro

In NZ Leads, go to Settings → Integrations → Add integration → Housecall Pro. The Housecall Pro window opens.

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

Generate an API key in Housecall Pro

The card lists the steps: log in to Housecall Pro with admin access, go to your app store, find the API app card and click View Details, click Generate API Key, name the key, and copy it.

Save the key

Paste the key into Enter your API key and click Save. NZ Leads checks the key with Housecall Pro before saving it.

Turn on Enabled

The key is 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, sources, and voice agents that should send leads to Housecall Pro. Ticking a business covers all its sources, including sources added later. If you added Housecall Pro from a source’s tab, that source is already ticked, unless it uses another Housecall Pro integration.

Options

Enabled

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

Create lead in CRM only when contact info is received

Label: Create lead in CRM only when contact info is received. Default: off.

Create only new leads

Label: Create only new leads. Default: off.

This option looks at the conversation, not at Housecall Pro: it doesn’t search Housecall Pro for an existing record.

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

Label: 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.

Press to validate API token

Click the panel that shows your API key to expand it, then click Press to validate API token. You’ll see whether the key is valid.

Removing the API key

In the same panel, click the trash icon and confirm with Yes. The key is cleared and the integration sends nothing until you save a key again and turn on Enabled. To remove the integration itself, click Delete integration in the window.

Matching and deduplication

NZ Leads remembers the Housecall Pro customer it created for a lead and updates that customer on later messages, instead of creating another one. It doesn’t search Housecall Pro for an existing customer.

A note on appointment booking

Housecall Pro also powers appointment scheduling inside NZ Leads’s AI Assistant and Voice Agent. If your voice agent or AI text flow books an appointment, Housecall Pro is the calendar being read and written. That’s a separate setting with its own API key: choose Housecall Pro under Appointment Scheduling in Conversation Setup, or in a voice agent’s Appointments section (see Voice Agent Scheduling Integrations). This page only covers customer creation for inbound leads.

Turning Housecall Pro off

Customers already in Housecall Pro stay there.

Troubleshooting


Questions about the Housecall Pro integration? Email support@nzleads.com.

Get Started