Outbound Webhooks
Outbound Webhooks push lead data from LeadHub to an external URL whenever a lead event occurs. Use this to sync leads to a CRM, trigger Zapier workflows, or notify external systems.
How Outbound Webhooks Workโ
- You create an outbound webhook with a target URL and the events to listen to.
- When the selected event occurs (e.g. a new lead is created), LeadHub sends an HTTP POST request to your URL.
- The payload is a JSON object containing the full lead data.
Creating an Outbound Webhookโ
- Go to Integrations โ Outbound Webhooks.
- Click New Outbound Webhook.
- Configure:
| Field | Description |
|---|---|
| Name | Internal name (e.g. "Sync to HubSpot") |
| URL | The external endpoint that receives the POST |
| Events | Which events trigger this webhook (see below) |
| Secret | Optional HMAC secret for request signature verification |
| Active | Toggle to enable or disable |
- Click Save.
Available Eventsโ
| Event | When it fires |
|---|---|
lead.created | A new lead record is created |
lead.updated | A lead is modified |
lead.deleted | A lead is deleted |
lead.stage_changed | A lead moves to a new pipeline stage |
lead.assigned | A lead is assigned to a user |
form.submitted | A form submission is received |
Payload Formatโ
All outbound webhooks POST a JSON body:
{
"event": "lead.created",
"occurred_at": "2026-04-29T10:30:00Z",
"lead": {
"id": 123,
"first_name": "Jane",
"last_name": "Smith",
"email": "[email protected]",
"phone": "+1-555-000-0000",
"source": "web_form",
"status": "new",
"lead_score": 45,
"pipeline": "Sales Pipeline",
"stage": "New Lead",
"assigned_to": "[email protected]",
"tags": ["vip", "from-webinar"],
"created_at": "2026-04-29T10:30:00Z"
}
}
HMAC Signature Verificationโ
If you set a Secret, LeadHub signs each request with an HMAC-SHA256 signature.
The signature is sent in the X-LeadHub-Signature header.
To verify (example in PHP):
$computed = 'sha256=' . hash_hmac('sha256', $rawBody, $secret);
if (!hash_equals($computed, $_SERVER['HTTP_X_LEADHUB_SIGNATURE'])) {
http_response_code(401);
exit;
}
Webhook Delivery and Retriesโ
LeadHub delivers webhooks asynchronously via the queue. If the external endpoint returns a non-2xx response, delivery is retried up to 3 times with exponential backoff.
See Webhook Log to review delivery history.
Disabling vs Deletingโ
- Disable: Toggle Active off โ no events are sent, but the webhook is preserved.
- Delete: Permanently removes the webhook configuration.