How to Connect n8n
Step-by-step guide to send qualified leads from Zero Bad Leads to n8n workflows.
What is n8n?#
n8n is an open-source automation platform that can run in the cloud or on your own server (self-hosted). With the Zero Bad Leads integration, every time a lead is qualified, the data is automatically sent to an n8n workflow — with full control over your data.
Prerequisites#
- An n8n instance (cloud or self-hosted)
- An active scoring profile in Zero Bad Leads
If you use self-hosted n8n, make sure the webhook URL is publicly accessible (via HTTPS). Local URLs like http://localhost will not work.
Get the webhook URL in n8n#
Create a new workflow
Access your n8n instance and create a new workflow.
Add the Webhook node
Click "+" and search for "Webhook". Add the node to the workflow.
Configure the webhook
In the Webhook node, configure:
- HTTP Method: POST
- Path: choose a path (or use the default one generated)
Copy the Production URL
In the Webhook node, copy the Production URL. It will have the format:
https://your-n8n.com/webhook/xxxxxxxxx
Use the Production URL, not the test URL. The test URL only works while the workflow is in listening mode.
Activate the workflow
Click "Activate" so the workflow is active and ready to receive data.
Connect in Zero Bad Leads#
Access Outbound Integrations
In the Zero Bad Leads sidebar, click Send Leads. Find the n8n card and click "Integrate".
Paste the webhook URL
Paste the Production URL you copied from n8n in the "Webhook URL" field.
Name and save
Give the integration a name (e.g., "n8n — Sales Pipeline") and click "Save".
Test the connection
Click "Test" to verify the URL is reachable and n8n responds correctly.
Data sent#
When a lead is qualified, Zero Bad Leads sends a POST with the following JSON data:
Standard fields#
| Field | Description |
|---|---|
lead_id | Unique lead ID |
email | Lead email |
phone | Phone number |
first_name | First name |
last_name | Last name |
company | Company |
job_title | Job title |
source | Lead source |
quality_score | Quality score (0-100) |
tags | Associated tags (includes lead tags + tags configured in the integration) |
Enrichment data#
If the lead has enrichment data (available on Pro and Scale plans), it is included in the enrichment object:
| Field | Description |
|---|---|
enrichment.company_name | Company name |
enrichment.industry | Industry sector |
enrichment.estimated_size | Estimated company size |
enrichment.job_title | Identified job title |
enrichment.linkedin_url | LinkedIn profile URL |
enrichment.company_city | Company city |
enrichment.company_state | Company state |
enrichment.website_url | Company website |
enrichment.headline | Profile headline |
Custom fields#
You can configure custom field mappings to control exactly which data is sent and with which names. When you configure field mapping, the payload is built according to your rules, allowing you to:
- Map any lead field to a custom name in the destination (e.g.,
email→contact_email) - Access nested data using dot notation (e.g.,
enrichment.linkedin_url) - Apply transformations to values:
lowercase,uppercase,trim,to_string,to_number,to_boolean
When field mapping is configured, the payload sent follows exclusively the rules defined in the mapping. This gives you full control over the data structure received in n8n.
Advanced settings#
On the integration configuration screen, click "Advanced settings" to access field mapping, tags, and transformations.
Related articles#
Related articles
How to Connect Make
Step-by-step guide to send qualified leads from Zero Bad Leads to Make (Integromat) scenarios.
How to Connect Zapier
Step-by-step guide to send qualified leads from Zero Bad Leads to Zaps in Zapier.
Configure Outbound Webhook
How to configure a generic webhook to send qualified leads to any external system.