Zero Bad Leads
Receive Leads2 min readFebruary 23, 2026

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:

FieldRecognized aliases
Emailemail, e-mail, email_address, correo
Phonetelefone, phone, celular, whatsapp, mobile
Namenome, name, primeiro_nome, first_name
Companyempresa, 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-key header
  • Confirm that the Content-Type is application/json
  • Check the logs under Logs in the sidebar for detailed errors