Configure webhook to receive leads
Learn how to configure the Zero Bad Leads webhook to automatically receive leads from any form or platform.
What is a webhook?#
A webhook is the endpoint that automatically receives your lead data. When a form is filled out on your landing page, the data is sent via HTTP POST to the Zero Bad Leads webhook URL.
Step by step#
Create an API Key
Go to Receive Leads → API Keys in the sidebar. Click "New API Key", give it a descriptive name (e.g., "Landing Page Form") and copy the generated key.
The API Key is only displayed once. Save it in a secure location.
Copy the webhook URL
The webhook URL follows this format:
https://ctmhfalurdthlddaprfd.supabase.co/functions/v1/webhook-receiver
You will use it when configuring your form.
Configure your form
In your form or platform, set up the webhook with:
- URL: the URL copied in the previous step
- Method: POST
- Header:
x-api-key: YOUR_API_KEY - Content-Type:
application/json
The request body should be a JSON with the lead fields:
{
"email": "john@company.com",
"name": "John Smith",
"phone": "+1 (555) 123-4567",
"company": "Company XYZ"
}
Test the webhook
Send a test lead through your form and check the Leads page to see if it appeared. The initial status will be "new" and after qualification it will change to "qualified" or "skipped".
Automatically recognized fields#
Zero Bad Leads recognizes over 100 field name variations in Portuguese, English, and Spanish. For example:
| Field | Recognized aliases |
|---|---|
email, e-mail, email_address, correo | |
| Phone | telefone, phone, celular, whatsapp, mobile |
| Name | nome, name, primeiro_nome, first_name |
| Company | empresa, company, razao_social, company_name |
Fields that are not automatically recognized are saved as custom fields, without consuming additional mapping.
Troubleshooting#
The lead doesn't appear on the platform?
- Check that the API Key is correct in the
x-api-keyheader - Confirm that the Content-Type is
application/json - Check the logs under Logs in the sidebar for detailed errors
Related articles
Integrate RD Station Form
Step-by-step guide to connect RD Station Marketing and receive leads from your forms in Zero Bad Leads.
Integrate Elementor Form
How to configure the Elementor form in WordPress to automatically send leads to Zero Bad Leads.
Field mapping
Understand how Zero Bad Leads maps fields automatically and how to configure custom mappings.