AccuLynx Integration
The AccuLynx integration turns a new NZ Leads lead into an AccuLynx contact and job. It is designed for roofing teams that want every inquiry, customer detail, and conversation reference available in AccuLynx without manual data entry.
You set AccuLynx 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 AccuLynx, under CRM and field service.
What gets created
For each eligible lead, NZ Leads creates:
- An AccuLynx contact with first and last name
- Phone number and email address, when available
- The name of the NZ Leads source the lead came from, as the contact’s company name
- A mailing address (street, city, ZIP code) when the lead has address details, with the billing address set to the same
- A related AccuLynx job
- Notes containing lead details, the first inquiry, the conversation link, and team memos
- A cross-reference back to the NZ Leads lead
If a phone number is captured after the contact and job already exist, NZ Leads can add that phone number to the existing AccuLynx contact. Phone numbers that cannot be normalized to 10 digits are preserved in the notes instead of being discarded.
Connect AccuLynx
Get an AccuLynx API key
Ask your AccuLynx account administrator for an API key that can create contacts and jobs.
Add AccuLynx in NZ Leads
Go to Settings → Integrations → Add integration → AccuLynx. The AccuLynx window opens.
You can also start from a source: open the source → Messaging Settings → Integrations tab → Add integration → Create new → AccuLynx. If the tab shows Business Settings Active, switch on Customize for Location first. To reuse an AccuLynx integration your account already has, pick it on the Use existing tab instead.
Save the API key
Under Connect AccuLynx, paste the key into API key and click Save. NZ Leads validates the key before storing the connection.
Choose the lead filters
Once the key is saved, the options appear. Turn on Create lead in CRM only when contact info is received if AccuLynx should only receive leads with a phone number or email. See Options for the others.
Enable the integration
Turn Enabled on. A new connection is saved switched off, so this step is required before leads begin syncing.
Choose where it’s used
Under Where it’s used, tick the businesses, source types, sources, and voice agents that should send leads to AccuLynx. Ticking a business covers all its sources, including sources added later. If you added AccuLynx from a source’s tab, that source is already ticked, unless it uses another AccuLynx integration.
Options
Enabled
Turns this AccuLynx integration on or off everywhere it’s used. To stop sending for one source only, switch AccuLynx off on that source’s Integrations tab instead.
Create lead in CRM only when contact info is received
Default: off.
- When on - AccuLynx gets the lead only when the customer shares a phone number or email, and only if CRMs is ticked under Trigger integrations: for that kind of contact info in the source’s Contact Info settings.
- When off - AccuLynx gets the lead as soon as the lead first reaches out, even before you have their contact info.
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 AccuLynx.
- When off - Those leads are sent too.
This option looks at the conversation, not at AccuLynx: it doesn’t search AccuLynx for an existing record.
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 - AccuLynx 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.
Duplicate protection
After creating the AccuLynx contact and job, NZ Leads stores both AccuLynx IDs on the lead. Later integration events reuse the saved contact and do not create a second job for the same NZ Leads lead.
Validate, change, or disconnect
Click the panel that shows your API key to expand it:
- Validate API key tests the saved key again.
- The trash icon disconnects: confirm with Yes. The API key is removed and the integration sends nothing until you save a key again and turn on Enabled.
To use a different key, paste it into API key under Update AccuLynx Configuration and click Save. Enabled and the options stay as they are. To remove the integration itself, click Delete integration in the window.
Turning AccuLynx off
- For one source - On that source’s Integrations tab, switch AccuLynx 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 AccuLynx window. Other sources keep sending.
- Everywhere - Turn off Enabled on the card, or click Delete integration in the AccuLynx window. Every place that used it stops sending.
Troubleshooting
- API key fails validation: copy the key again and confirm it belongs to an AccuLynx account with contact and job access.
- Connected but no job is created: confirm Enabled is on, that AccuLynx is on for the source on its Integrations tab, and that the options aren’t excluding the lead.
- Phone number appears only in notes: AccuLynx receives a structured phone only when it can be normalized to 10 digits.
- Address is incomplete: only the address fields captured on the lead can be sent.
- A duplicate job was skipped: the integration creates one AccuLynx job per NZ Leads lead by design.
Errors from the last 7 days mark the integration as Has errors on the Integrations page. Open it and click the warning icon at the top of its settings to read them, and use Validate API key when diagnosing a failed connection.
Questions about the AccuLynx integration? Email support@nzleads.com.