Pipedrive
The Pipedrive integration creates persons (Pipedrive’s name for contacts) in your Pipedrive account for every lead NZ Leads handles. Their name, email, and phone are written through automatically, so your pipeline always reflects what’s come in.
You set Pipedrive 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 sent to Pipedrive includes:
- Name
- Phone number
Connecting Pipedrive
Add Pipedrive
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 → Pipedrive. The Pipedrive window opens. If your account already has a Pipedrive integration, pick it on the Use existing tab instead.
Copy your Pipedrive API token
In Pipedrive, open your personal preferences → API and copy your personal API token.
Save the token
Under Add new API token, paste the token into Enter your API token and click Save. NZ Leads checks the token with Pipedrive first: it adds a test person and deletes it right away. If the token doesn’t work, nothing is saved and the card still shows Add new API token.
Turn on Enabled
The card now shows Pipe drive API token with the Enabled switch off. Turn it on. Nothing is sent to Pipedrive until it’s on.
Choose where it’s used
Pipedrive added from a source’s Integrations tab is already on for that source, unless the source already uses another Pipedrive integration. To use it for other sources, tick them under Where it’s used in the Pipedrive window, then click Done.
To add this Pipedrive integration to another source later, open that source’s Integrations tab → Add integration → Use existing and pick it. A source sends to one Pipedrive 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 Pipedrive 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 → Pipedrive 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 Pipedrive 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 Pipedrive 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 - Pipedrive 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 - Pipedrive 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 Pipedrive. 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 Pipedrive: it doesn’t search Pipedrive 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.
- Pipedrive 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 Pipedrive integration. Sources without an AI conversation (AI Assistant with Short or Long conversation in Conversation Setup) send no leads to Pipedrive 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 Pipedrive, with the same test person as when saving.
- The delete icon, then Yes, removes the token. Pipedrive gets nothing until you save a new token. The integration stays where it’s used.
Matching and deduplication
NZ Leads doesn’t look for existing persons in Pipedrive. It creates one person per lead, remembers it, and updates that person later, for example when the lead shares new contact info.
Turning Pipedrive off
- For one source - untick the source under Where it’s used in the Pipedrive window, or switch Pipedrive 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 Pipedrive card, or click Delete integration in the Pipedrive window. Every source that used it stops sending to Pipedrive.
Persons already in Pipedrive stay there.
Troubleshooting
- The token isn’t saved - The token is wrong, expired, or was deleted. Copy your personal API token from Pipedrive again and paste it.
- “Not set up yet” next to Pipedrive on a source’s Integrations tab - Enabled is off. Click Settings and turn it on.
- No persons appearing in Pipedrive - Check that Enabled is on and that Pipedrive is on for the source, check your Create lead in CRM only when contact info is received setting, and confirm your Pipedrive user has permission to create persons.
- A warning icon at the top of the card - Pipedrive refused a person or an update, 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.
- Duplicates - Each NZ Leads lead gets its own person, so someone who comes in as two leads, for example through two sources, gets two persons.
Questions about the Pipedrive integration? Email support@nzleads.com.