Skip to main content

Lead Sources โ€” Setup Guide

LeadHub can receive leads from 19 different sources. Most sources work via a webhook โ€” you paste a LeadHub-generated URL into the external platform, and leads flow in automatically.

How Every Webhook-Based Source Worksโ€‹

  1. Go to Integrations โ†’ Lead Sources and create a new connection.
  2. Select the source type and configure field mappings.
  3. Copy the generated Inbound Webhook URL.
  4. Paste the URL into the external platform (instructions per source below).
  5. Test by submitting a test lead โ€” it appears in your workspace within seconds.

Facebook Lead Ads (Meta)โ€‹

Facebook Lead Ads let users submit a form inside Facebook/Instagram without leaving the app.

Setup Stepsโ€‹

  1. Create a Lead Source Connection in LeadHub: Type โ†’ Facebook Lead Ads.
  2. Copy the Webhook URL.
  3. In Facebook Business Manager โ†’ All Tools โ†’ Lead Ads Forms โ†’ CRM Integration:
    • Select your Facebook Page.
    • Choose Connect your CRM โ†’ Other.
    • Paste the LeadHub Webhook URL.
    • Map the form fields to LeadHub fields.
  4. Test by submitting a test lead via the Test Lead button in Facebook.

Field Mapping Exampleโ€‹

Facebook FieldLeadHub Field
full_namefirst_name
emailemail
phone_numberphone

Alternatively, use Zapier or n8n as a bridge if you need more control over the payload.

Instagram Leadsโ€‹

Instagram Lead Ads share the same Meta Ads infrastructure as Facebook Lead Ads. Follow the same steps above โ€” Instagram ads and Facebook ads both deliver to the same webhook endpoint.

TikTok Lead Generationโ€‹

TikTok Lead Gen captures leads directly within TikTok ads.

Setup Stepsโ€‹

  1. Create a Lead Source Connection: Type โ†’ TikTok Lead Generation.
  2. Copy the Webhook URL.
  3. In TikTok Ads Manager โ†’ Assets โ†’ Lead Generation โ†’ Webhook:
    • Click Create Webhook.
    • Paste the LeadHub Webhook URL.
    • Select the fields to deliver.
  4. Submit a test lead to verify delivery.

Notesโ€‹

  • TikTok sends a verification ping to the URL โ€” LeadHub responds with the correct token automatically.
  • Field names in TikTok may be: name, email, phone_number.

LinkedIn Lead Gen Formsโ€‹

LinkedIn Lead Gen Forms capture leads from LinkedIn Sponsored Content.

Setup Stepsโ€‹

  1. Create a Lead Source Connection: Type โ†’ LinkedIn Lead Gen Forms.
  2. Copy the Webhook URL.
  3. In LinkedIn Campaign Manager โ†’ Account Assets โ†’ Lead Gen Forms โ†’ Integrations:
    • Choose your Lead Gen form.
    • Under Integrations, select Other integrations โ†’ Webhook.
    • Paste the Webhook URL.
  4. Map form fields (LinkedIn sends firstName, lastName, emailAddress, phone).

WhatsApp Businessโ€‹

Capture leads who message your WhatsApp Business account.

Setup via WhatsApp Business API (Cloud API)โ€‹

  1. Create a Lead Source Connection: Type โ†’ WhatsApp Business.
  2. Copy the Webhook URL.
  3. In Meta Business โ†’ WhatsApp โ†’ Configuration โ†’ Webhooks:
    • Set the Callback URL to the LeadHub Webhook URL.
    • Set the Verify Token (shown in the LeadHub connection settings).
    • Subscribe to messages events.
  4. When a user sends a message to your WhatsApp number, LeadHub creates a lead from their name and phone number.

Setup via Zapier (Easier for Most Users)โ€‹

  1. Create a Zapier Zap: Trigger โ†’ WhatsApp Business (or use a third-party WhatsApp connector).
  2. Action โ†’ Webhooks by Zapier โ†’ POST to your LeadHub Webhook URL.
  3. Map the contact fields.

Telegramโ€‹

Capture leads who message your Telegram bot.

Setup Stepsโ€‹

  1. Create a Telegram bot via @BotFather on Telegram:
    • Send /newbot to BotFather.
    • Choose a name and username.
    • Copy the Bot Token.
  2. In LeadHub, create a Lead Source Connection: Type โ†’ Telegram.
  3. Enter the Bot Token in the connection configuration.
  4. LeadHub registers a webhook on the Telegram API automatically.
  5. When a user sends /start or any message to your bot, a lead is created with their Telegram name and username.

What LeadHub Captures from Telegramโ€‹

Telegram FieldLeadHub Field
first_nameFirst Name
last_nameLast Name
usernamestored in Notes
message textstored in Notes

Viberโ€‹

Capture leads who message your Viber Business account.

Setup Stepsโ€‹

  1. Create a Viber Business Account at partners.viber.com.
  2. Get your Viber Bot Token.
  3. In LeadHub, create a Lead Source Connection: Type โ†’ Viber.
  4. Enter the Bot Token โ€” LeadHub sets up the webhook automatically.
  5. When a user messages your Viber account, a lead is created.

Twitter / Xโ€‹

Capture leads from Twitter / X via DMs or lead generation cards.

  1. In Zapier, create a Zap: Trigger โ†’ Twitter โ†’ New Direct Message.
  2. Action โ†’ Webhooks by Zapier โ†’ POST to your LeadHub Webhook URL.
  3. Map sender_screen_name to a custom field and text to Notes.

Twitter's API access requires a Developer Account. For most users, Zapier is the easiest path.

Snapchat Lead Adsโ€‹

Snapchat Lead Ads work similarly to Facebook Lead Ads.

Setup Stepsโ€‹

  1. Create a Lead Source Connection: Type โ†’ Snapchat Lead Ads.
  2. Copy the Webhook URL.
  3. In Snapchat Ads Manager โ†’ Business โ†’ Snap Pixel & APIs โ†’ Lead Webhook:
    • Paste the Webhook URL.
    • Select which Lead Attachment forms to connect.
  4. Snapchat sends: full_name, email, phone_number.

Pinterest Lead Adsโ€‹

Setup Stepsโ€‹

  1. Create a Lead Source Connection: Type โ†’ Pinterest Lead Ads.
  2. Copy the Webhook URL.
  3. In Pinterest Ads Manager โ†’ Lead Ads โ†’ Webhook (or via Zapier):
    • Paste the Webhook URL or set up a Zapier bridge.
  4. Pinterest sends: email, first_name, last_name.

Google Ads Lead Form Extensions let searchers submit their info directly in Google search results.

Setup Stepsโ€‹

  1. Create a Lead Source Connection: Type โ†’ Google Ads Lead Forms.
  2. Copy the Webhook URL.
  3. In Google Ads โ†’ Lead Form Extension โ†’ Edit โ†’ Webhook integration:
    • Paste the Webhook URL.
    • Enter the Webhook Key (shown in the LeadHub connection โ€” leave blank if not required).
  4. Google Ads sends: user_column_data array with full_name, email, phone_number, postcode.

Field Mapping for Google Adsโ€‹

Google Ads sends a structured JSON with lead_id, user_column_data, column_id, string_value. Configure field mapping to extract string_value from the array.

YouTube Lead Formsโ€‹

YouTube Lead Forms (part of Google Ads) work identically to Google Ads Lead Form Extensions. Follow the same steps above โ€” YouTube ads use the same Google Ads webhook infrastructure.

Microsoft Advertising (Bing Ads)โ€‹

Setup via Zapierโ€‹

  1. In Zapier, create a Zap: Trigger โ†’ Microsoft Advertising โ†’ New Lead.
  2. Action โ†’ Webhooks by Zapier โ†’ POST to your LeadHub Webhook URL.
  3. Map fields: first_name, last_name, email, phone.

Typeformโ€‹

Setup Stepsโ€‹

  1. Create a Lead Source Connection: Type โ†’ Typeform.
  2. Copy the Webhook URL.
  3. In Typeform โ†’ Your Form โ†’ Connect โ†’ Webhooks:
    • Click Add a webhook.
    • Paste the LeadHub Webhook URL.
    • Enable the webhook.
  4. Typeform sends the full form response JSON on each submission.

Field Mappingโ€‹

Typeform sends answers as an array. Use dot notation to map: answers.0.email โ†’ email, answers.1.text โ†’ first_name (based on your form field order and types).

JotFormโ€‹

Setup Stepsโ€‹

  1. Create a Lead Source Connection: Type โ†’ JotForm.
  2. Copy the Webhook URL.
  3. In JotForm โ†’ Your Form โ†’ Settings โ†’ Integrations โ†’ Webhooks:
    • Paste the Webhook URL.
    • Click Complete Integration.
  4. JotForm sends form fields with their configured field names.

Field Mappingโ€‹

JotForm sends fields with keys like q1_fullName, q2_email, q3_phoneNumber. Map these to LeadHub fields. Use the connection field mapping to set: q2_email โ†’ email, etc.

Calendlyโ€‹

Capture leads who book a meeting via Calendly.

Setup Stepsโ€‹

  1. Create a Lead Source Connection: Type โ†’ Calendly.
  2. Copy the Webhook URL.
  3. In Calendly โ†’ Integrations โ†’ Webhooks โ†’ Create New Webhook:
    • Paste the Webhook URL.
    • Select invitee.created event.
    • Choose which Event Types to monitor.
  4. When someone books a meeting, Calendly sends: first_name, last_name, email, questions_and_answers.

LeadHub Web Formโ€‹

When someone submits a form you built with the LeadHub Form Builder, a lead is created automatically โ€” no webhook setup needed. See Form Builder.

Email (IMAP)โ€‹

Capture leads from inbound emails to a monitored inbox.

Setup Stepsโ€‹

  1. Create a dedicated email address for lead capture (e.g. [email protected]).
  2. Go to Integrations โ†’ Lead Sources and create a new connection: Type โ†’ Email (IMAP).
  3. Enter:
    • IMAP Host โ€” your mail server (e.g. mail.yourcompany.com)
    • IMAP Port โ€” usually 993 (SSL) or 143
    • Username โ€” the email address
    • Password โ€” the email password
    • Folder โ€” usually INBOX
  4. LeadHub polls the inbox every 5 minutes (via the cron job) and creates a lead from each new email.

What is Captured from Emailโ€‹

Email FieldLeadHub Field
From: NameFirst Name
From: AddressEmail
Subjectstored in Notes
Bodystored in Notes

Manual Entryโ€‹

Create leads directly in LeadHub without any external integration. Go to Leads โ†’ All Leads โ†’ New Lead and fill in the details. See Managing Leads.

Generic Webhook (Any Platform)โ€‹

For any platform not listed above, use the Generic Webhook connection type. You get a URL that accepts any JSON payload, and you configure field mapping to extract lead data. Compatible with any tool that can POST JSON โ€” including custom applications, Typebot, Botpress, and more.

curl -X POST https://yourdomain.com/inbound/YOURTOKEN \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","first_name":"Test","last_name":"Lead","phone":"+1555000000"}'