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:
- First name
- Last name
- Phone number
- Zip code
- Lifecycle stage, set to lead
- A note attached to the contact with the source name, the platform the lead came from, and the original inquiry
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.
- When on - HubSpot 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 - HubSpot gets the lead as soon as the lead first reaches out, even before you have their contact info.
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 HubSpot. 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 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.
- Turning it on asks you to confirm with Enable.
- HubSpot then gets a lead only once the AI confirms the lead is interested, and again with each new message after that.
- It applies to every place that uses this HubSpot integration. Sources without an AI conversation (AI Assistant with Short or Long conversation in Conversation Setup) send no leads to HubSpot while it’s on.
- Can’t be turned on together with Create lead in CRM only when contact info is received or Create only new leads.
Checking or changing the token
The saved token is shown in a row on the card. Expand the row:
- Press to validate API token checks the token with HubSpot, with the same test contact as when saving.
- The delete icon, then Yes, removes the token. HubSpot gets nothing until you save a new token. The integration stays where it’s used.
Matching and deduplication
- NZ Leads remembers the HubSpot contact it created for a lead. Later updates for that lead, such as new contact info or a finished call, update the same contact.
- NZ Leads doesn’t search HubSpot before creating a contact. If HubSpot already has a contact with the lead’s email, HubSpot refuses to create another one, and the error shows on the card.
- If an update would give the contact an email that already belongs to another HubSpot contact, NZ Leads updates that other contact instead.
Turning HubSpot off
- For one source - untick the source under Where it’s used in the HubSpot window, or switch HubSpot off on that source’s Integrations tab. If the tab shows Business Settings Active, switch on Customize for Location first. Other sources keep sending.
- Everywhere - turn off Enabled on the HubSpot card, or click Delete integration in the HubSpot window. Every source that used it stops sending to HubSpot.
Contacts already in HubSpot stay there.
Troubleshooting
- An error when you save the token - The token is wrong, was revoked, or doesn’t have the
crm.objects.contacts.writescope. Create a new token in HubSpot and paste it. - “Not set up yet” next to HubSpot on a source’s Integrations tab - Enabled is off. Click Settings and turn it on.
- No contacts appearing in HubSpot - Check that Enabled is on and that HubSpot is on for the source. If Create lead in CRM only when contact info is received is on, the lead hasn’t shared a phone or email yet, or CRMs isn’t checked in the Contact Info tab. If Create only new leads is on, your business may have messaged the lead before NZ Leads received the conversation. If Notify this integration only after the AI determines the lead is interested is on, the AI hasn’t confirmed interest yet.
- A warning icon at the top of the card - HubSpot refused a contact, an update, or a note, and the integration shows Has errors in your integrations list. Click the icon to read the errors from the last 7 days, and Clear Errors once you’ve fixed the cause.
- Duplicate contacts - Each NZ Leads lead gets its own contact, so a person who comes in as two leads, for example through two sources, can get two contacts. See Matching and deduplication.
Questions about the HubSpot integration? Email support@nzleads.com.