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:
- First name
- Last name
- Mobile number
- A tag with the name of the NZ Leads source the lead came from
- A lead source that names the source type, such as Yelp
- Notes: your team’s memos on the lead
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.
- When on - Housecall Pro gets the lead only once the lead has shared a phone number or email, and only if CRMs is checked under Trigger integrations: in the source’s Contact Info tab for that kind of contact info.
- When off - Housecall Pro gets the lead as soon as the lead first reaches out, even before you have their contact info. The customer is then updated as new messages come in.
Create only new leads
Label: Create only new leads. Default: off.
- When on - If your business had already messaged the lead before NZ Leads first received the conversation, the lead’s contact info is not sent to Housecall Pro. New messages in a conversation don’t send the lead again either.
- When off - Those leads and messages are sent too.
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.
- When on - Housecall Pro 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.
- Can’t be turned on together with Create lead in CRM only when contact info is received or Create only new leads.
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
- For one source - On that source’s Integrations tab, switch Housecall Pro 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 Housecall Pro window. Other sources keep sending.
- Everywhere - Turn off Enabled on the card, or click Delete integration in the Housecall Pro window. Every place that used it stops sending.
Customers already in Housecall Pro stay there.
Troubleshooting
- The key isn’t saved - Housecall Pro didn’t accept it. Generate a new API key in Housecall Pro and paste it again.
- The key shows as invalid - The key was revoked or is wrong. Remove it, save a new one, and turn on Enabled again.
- No customers appearing - Check that Enabled is on and that Housecall Pro is on for the source on its Integrations tab. With Create lead in CRM only when contact info is received on, also check CRMs under Trigger integrations: in Contact Info. With Notify this integration only after the AI determines the lead is interested on, nothing is sent until the AI decides the lead is interested.
- Has errors - The Integrations page marks an integration with errors from the last 7 days. Open it and click the warning icon at the top of its settings to read them. Clear Errors clears them.
Questions about the Housecall Pro integration? Email support@nzleads.com.