Connect Zapier, Make or n8n
Start an automation when something happens in HeyLeads, and add leads to HeyLeads from an automation.
HeyLeads doesn't have its own app inside these tools yet. You use their built-in webhook and HTTP steps instead, which takes a few more clicks but works the same way. There are two directions, and you can use either or both.
- HeyLeads to your tool: a reply, an accepted request or a finished campaign starts your Zap, scenario or workflow.
- Your tool to HeyLeads: an automation adds leads to a HeyLeads list.
#A. Send HeyLeads events to Zapier
In Zapier, choose Create, then Zap. For the trigger choose Webhooks by Zapier, event Catch Hook
Copy the Custom Webhook URL
It starts with
https://hooks.zapier.com/hooks/catch/.In HeyLeads, open Settings, Integrations, Zapier and paste it into Zapier URL
Under Send me, pick events
It starts at Positive replies only. Other quick choices: Replies, Replies and accepted requests, Everything.
Choose Connect Zapier
A signing secret appears once. Zapier's Catch Hook can't check signatures, so you can close it.
Send a test and add your next step in Zapier
In Zapier choose Test trigger, then in HeyLeads Send test. A sample with the event
webhook.testshould appear.
#A. Send HeyLeads events to Make
In Make, create a scenario and add the Webhooks module, then Custom webhook, Add, and name it HeyLeads
Leave the optional API key authentication and IP restrictions off.
Copy the address Make shows
It starts with
https://hook.and ends inmake.com.In HeyLeads, open Settings, Integrations, Make, paste it into Make URL, pick events and choose Connect Make
In Make choose Run once, then Send test in HeyLeads
#A. Send HeyLeads events to n8n
In n8n, start a workflow with a Webhook node
Set HTTP Method to
POST, replace the path with a long random one, such asheyleads-8f3k29xq7d, and set Respond to Immediately. The path is what keeps strangers out.Copy the Production URL, not the Test URL
In HeyLeads, open Settings, Integrations, n8n, paste it into n8n URL, pick events and choose Connect n8n
In n8n, activate the workflow so the Production URL starts listening
A self-hosted n8n must be reachable from the internet over https. Addresses on a private network, such as localhost, are refused. The n8n page also has a ready workflow you can paste into an empty canvas. It tags every positive reply replied-positive.
#B. Add leads to HeyLeads from your tool
On the same HeyLeads page, under The other direction: add leads, choose Create a key for this and copy it
It's shown once. Use a separate key per tool so you can revoke it alone.
In your tool, add a step that makes a web request
Zapier: Webhooks by Zapier, Custom Request. Make: HTTP, Make a request. n8n: HTTP Request.
Set the method to
POSTand the URL tohttps://YOUR_HEYLEADS_ADDRESS/api/v1/lists/LIST_ID/leadsYour address and the list's ID are shown on the page.
Add the headers
Authorization: Bearer YOUR_API_KEYandContent-Type: application/jsonSend the lead as JSON in the body
{ "rows": [ { "fullName": "Ada Lovelace", "linkedinUrl": "https://www.linkedin.com/in/ada-lovelace", "company": "Analytical Engines", "email": "ada@example.com" } ] }People already in HeyLeads (matched by LinkedIn link) are skipped, not moved or duplicated. Adding someone to a list doesn't contact them.
#If something goes wrong
| What you see | What it means |
|---|---|
| Webhook URLs must start with https:// | You pasted an address starting with http. Copy it again. |
| The tool finds no sample | Start the tool's test first so it's waiting, then press Send test in HeyLeads. |
401 unauthenticated | The key is missing, mistyped or revoked. The header must read Bearer, a space, then the key. |
403 forbidden | The key's access level is too low. Use Member or higher. |
422 invalid | The JSON is broken, or has a field next to rows that the call doesn't know. |
429 rate_limited | Too many calls this minute. Wait for Retry-After, or send up to 5,000 rows in one call. |
| The tile says Paused | The endpoint was switched off, or switched off after 20 failed deliveries in a row. Fix the cause and flip it on. |