HubSpot

The HubSpot integration creates and updates HubSpot contacts automatically. Every lead NZ Leads talks to is sent to HubSpot with their name, phone, email, and zip code, plus a note describing where the lead came from and what they asked about.

ℹ️

You set HubSpot up once and then choose where it’s used: which businesses, sources, and voice agents send leads to it. Add it from a source’s Messaging Settings → Integrations tab, or from Settings → Integrations in the menu, which lists all your integrations.

What gets synced

Every lead pushed into HubSpot includes:

After a voice-agent call with the lead, HubSpot also gets a Call Finished note with the phone number, the call summary, and the recording link.

Connecting HubSpot

Add HubSpot

In NZ Leads, open the source → Messaging Settings → Integrations tab. If the tab shows Business Settings Active, switch on Customize for Location first. Then click Add integration → Create new → HubSpot. The HubSpot window opens. If your account already has a HubSpot integration, pick it on the Use existing tab instead.

Create an access token in HubSpot

The card lists the steps: in your HubSpot settings, go to Integrations → Legacy Apps, create a private app with the scope crm.objects.contacts.write, and copy the access token from the app’s Auth tab.

Save the token

Paste the token into Enter your access token and click Save. NZ Leads checks the token with HubSpot first: it creates a test contact and archives it right away. If HubSpot refuses the token, you see an error and nothing is saved.

Turn on Enabled

The card now shows HubSpot Integration with the Enabled switch off. Turn it on. Nothing is sent to HubSpot until it’s on.

Choose where it’s used

HubSpot added from a source’s Integrations tab is already on for that source, unless the source already uses another HubSpot integration. To use it for other sources, tick them under Where it’s used in the HubSpot window, then click Done.

To add this HubSpot integration to another source later, open that source’s Integrations tab → Add integration → Use existing and pick it. A source sends to one HubSpot integration at a time: turning on another one there replaces the current one after you confirm. Ticking a business under Where it’s used turns HubSpot on for that business’s sources, including future ones. Sources follow their business unless they choose differently on their own Integrations tab.

In Settings → Integrations, Add integration → HubSpot adds the integration to the business selected in the sidebar and opens its window. Tick the places that should use it under Where it’s used.

Options

Enabled

Turns this HubSpot integration on or off everywhere it’s used. It’s off after you save a token. To stop sending one source’s leads only, switch HubSpot 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 HubSpot: it doesn’t search HubSpot 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.

Checking or changing the token

The saved token is shown in a row on the card. Expand the row:

Matching and deduplication

Turning HubSpot off

Contacts already in HubSpot stay there.

Troubleshooting


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

Get Started