Webhooks
A webhook sends each event — a lead scored, an outcome recorded — to a URL of yours as soon as it happens: your CRM, Zapier, Make, n8n or your own server. Set one up with Add webhook.
Adding a webhook
- URL — a public
https://address that acceptsPOSTrequests. - Name — for you, e.g. "CRM".
- Events — which events to send (see below).
After creating it you see its signing secret once. Copy it into your receiving system to verify that requests really come from Leadveyor.
Events
| Event | Sent when |
|---|---|
| Lead scored | A new lead got its score, or a repeat message changed it. Most integrations need only this one. |
| Lead created | A new lead was extracted. |
| Lead updated | A repeat message was merged into a lead, or its message was processed again. |
| Outcome recorded | Won, lost or another outcome was recorded or removed. |
| Junk | A message was set aside as junk or not a lead. |
| Failed | A message couldn't be processed after all retries. |
Each event carries the full lead (or message) — contact, request, fields, score, tier and the breakdown of every criterion. The payloads are described in Events.
Deliveries and retries
Open a webhook to see its deliveries: each event, whether it succeeded, your server's response and when. A delivery succeeds when your URL answers with a 2xx status within 10 seconds.
- A failed delivery is retried automatically with growing pauses (1, 2, 4… minutes) — up to 8 attempts over about 2 hours.
- Retry sends a failed delivery again right away.
- Send test event sends a sample event, to check your endpoint.
- After 10 failed deliveries in a row the webhook is disabled, so a broken endpoint doesn't pile up errors; the reason is shown. Fix the endpoint and click Enable.
Verifying webhooks
Every request has a Leadveyor-Signature header made with the signing secret. Check it before trusting the request — the Webhooks guide shows how, with code. New secret replaces the secret (the old one stops working at once — update your receiver right after).
Disable stops sending without deleting the webhook; Delete removes it.