Integrations Overview
NZ Leads can push every inquiry it handles into the tools you already use - your CRM, your team chat, or any other app connected through Zapier. Once an integration is turned on, lead data flows over automatically as conversations happen. Voice agents send their call reports through integrations too.
Each integration is set up once: one Slack channel, one HubSpot account, one email address. Then you turn it on where it’s used - for a whole business, for one source type of a business, for single sources, or for voice agents. Change its settings once and every place that uses it gets the change.
Getting here
In NZ Leads, open Settings → Integrations in the sidebar. The page lists the integrations of the business picked in the sidebar’s Business switcher, or of all your businesses when All Businesses is selected.
You can also manage integrations where they’re used:
- A source or a business - Messaging Settings → Integrations tab. See the Integrations tab.
- A voice agent - open the agent → Integrations. See Voice Agent Integrations.
Each row shows the integration’s name, its kind and what it sends to (a channel, an address, a webhook host), its Usage (for example Used by 5 sources, or Not used yet) and its Status. When the list has integrations of more than one business, each row also names the business it belongs to. Click a row to open the integration.
How the Integrations tab is organized
A source’s (or business’s) Messaging Settings → Integrations tab lists the integrations added to that place, one row each:
- The switch turns that integration on or off here. On a business, the change reaches the sources under it (see Where it’s used).
- Settings opens the integration’s window (see The integration window).
- Add integration adds one: Use existing picks an integration your account already has, Create new sets up a new one.
- All integrations opens the Integrations page.
While a source uses its business’s integrations, the tab is locked: turn on Customize for Location first. Voice Agent and Call Bridge aren’t on this tab: see Calls are set up per source.
Jump to a category
CRM Systems
Send leads to HubSpot, Pipedrive, Workiz, LeadConnector (GoHighLevel), Housecall Pro, ServiceTitan, AccuLynx, Quickbase, SmartMoving, Salesforce, Monday.com, or Zapier.
Communication Tools
Get notified when leads come in via email, SMS, Slack, Telegram, or push the conversation into LeadConnector Messaging Sync.
REST Webhook (Custom CRM)
For any CRM or internal system not in the supported list - NZ Leads POSTs lead events as JSON to a URL you host, with an X-Secret-Key header for verification.
Lead Reply API
Paired with the REST Webhook - lets an external system send replies back into NZ Leads so they're delivered to the lead as if sent from inside the app.
Call Bridge
When a lead shares a phone number, NZ Leads calls you first and then connects you to the lead on the same line.
Add an integration
Pick the business
In the sidebar’s Business switcher, pick the business the integration should belong to. With All Businesses selected, Add integration asks you to “Choose a business first.” An integration can be used by its business and by the businesses under it.
Click Add integration
Click Add integration and pick a kind. They’re grouped:
- Team notifications - Email, SMS, Slack, Telegram.
- CRM and field service - AccuLynx, Housecall Pro, HubSpot, LeadConnector, LeadConnector Messaging Sync, Monday.com, Pipedrive, Quickbase, Salesforce, ServiceTitan, SmartMoving, Workiz.
- Webhooks and automation - Lead Reply API, REST webhook, Zapier.
Set it up
The integration’s window opens. Fill in its Settings: sign in, paste an API key, verify an email address or phone number, pick a channel - each integration’s page explains its steps. Most integrations have an Enabled switch there.
Choose where it’s used
Under Where it’s used, tick the businesses, source types, sources or voice agents that should send to it. Click Done.
An integration added with Add integration → Create new on a place’s Integrations tab is used by that place right away, unless the place already uses an integration of the same kind. One added on the Integrations page isn’t used anywhere until you tick places under Where it’s used.
The integration window
Open an integration from the Integrations page, with Settings next to it on a place’s Integrations tab, or by clicking its icon on a source’s row on the Sources page. The window shows:
- The name - click the pencil to rename it. Under the name: its kind, the business it belongs to, and its status.
- Settings - the integration’s own settings. They’re shared by every place that uses it.
- Where it’s used - every business, source type, source and voice agent you can see, with a checkbox each. Search them, or expand the tree.
- Delete integration - removes it from every place that uses it.
Where it’s used
- A business checkbox switches all source types below it, including sources added later.
- A source type under a business, or a single source, makes a narrower change.
- Voice agents are listed separately. Ticking a business doesn’t turn an integration on for its voice agents: tick each agent. A call with a source’s lead also reports to that source’s integrations, and an incoming call also to the integrations of the sources that use the agent on their Calls tab. A destination used in more than one of these gets one message.
- A place that gets the integration from a business above shows Through and that business’s name.
A place uses one integration of each kind: one Slack channel, one HubSpot account, one email integration, and so on. Ticking a place that already uses another integration of the same kind asks you to Replace it.
A change at a business reaches the places under it. Places that switched the integration off themselves follow the business again; places that use another integration of the same kind keep theirs.
Statuses and errors
| Status | Meaning |
|---|---|
| Set up | Configured and switched on. |
| Not set up yet | Its settings aren’t finished, or it’s switched off in its own settings. It sends nothing. |
| Has errors | Sending failed recently. Open the integration: the warning icon in Settings shows the errors. |
| Needs reconnecting | A copy made without its sign-in. It sends nothing until someone signs in again in its settings. |
NZ Leads shows integration errors from the last 7 days. On the Sources page, an integration with errors is flagged on the source’s row: click its icon to open it and see the errors.
When a source, business or voice agent moves to another account while it used an integration that also stays with the old account, the moved places get a copy of that integration.
- Copies of sign-in integrations (LeadConnector, LeadConnector Messaging Sync, Salesforce, Slack) show Needs reconnecting: they send nothing until someone signs in again in their settings.
- Copies of Zapier and Lead Reply API get a new key and show Has errors with an explanation. The Zapier copy stays off until your Zap connects again with the new API key. The Lead Reply API copy stays on: give your system the new secret key.
Who can change integrations
- An integration - its settings, name and deletion: admins and managers of the business it belongs to, or of a business above it. Others see it as Managed by that business, without its settings.
- Where it’s used - admins and managers of a place’s business (or a business above it) can turn integrations on or off there. People with access to one source only see what it uses, read only.
Calls are set up per source
The Voice Agent that calls a source’s leads and Call Bridge aren’t shared integrations: they’re set on the Calls tab of each source’s (or business’s) Messaging Settings. See Call Bridge.
Common options on CRM cards
Many CRM integrations offer these filters. The exact options depend on the connector, so use each integration’s dedicated page for the final behavior. They’re in the integration’s settings and apply to every place that uses it:
- Create lead in CRM only when contact info is received - only push the lead once you’ve collected a phone number or email.
- Create only new leads - don’t send a lead’s contact info when your business had already messaged the lead before NZ Leads received the conversation.
- Notify this integration only after the AI determines the lead is interested - wait for the AI to confirm interest (needs AI Assistant with Short or Long conversation). Places without an AI conversation send nothing to the integration while this is on.
Which CRMs are supported?
NZ Leads has direct connectors for HubSpot, Pipedrive, Workiz, LeadConnector (GoHighLevel), Housecall Pro, ServiceTitan, AccuLynx, Quickbase, SmartMoving, Salesforce, and Monday.com. It also supports Zapier for no-code routing. If your CRM is not on that list, use REST Webhook (Custom CRM) to have NZ Leads POST lead events to a URL you control.
Which communication tools are supported?
For team notifications, NZ Leads supports SMS, Slack, Telegram, and Email. See Communication Tools for setup.
Questions about integrations? Email support@nzleads.com.