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 accepts POST requests.
  • 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

EventSent when
Lead scoredA new lead got its score, or a repeat message changed it. Most integrations need only this one.
Lead createdA new lead was extracted.
Lead updatedA repeat message was merged into a lead, or its message was processed again.
Outcome recordedWon, lost or another outcome was recorded or removed.
JunkA message was set aside as junk or not a lead.
FailedA 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.

Was this page helpful?