Home / Docs / Webhooks

Webhooks

Growth and Premium. Outbound link.clicked events so you do not poll the API.

Redirects do not wait on your server. Delivery is async. Events are sampled (default about 1 in 10 after a small first-click burst).

Register

Dashboard or POST /v1/webhooks with an https URL. You receive a secret once. HMAC-SHA256 over the raw body; header X-Lit-Signature: sha256=<hex>.

Payload

No raw IP.

{
  "event": "link.clicked",
  "link_id": "lnk_...",
  "slug": "launch",
  "short_url": "https://lit.onl/launch",
  "clicked_at": "2026-09-18T12:00:00Z",
  "country": "DE",
  "ua_family": "Safari"
}

Reliability

Retries with backoff on 5xx and timeouts. Repeated failure disables the endpoint. Re-enable after you fix the receiver.

CRUD in the API reference.