lit.onl
Log in

Home / Docs / Webhooks

Webhooks

Outbound lit.onl link.clicked webhooks so you do not poll the API — dashboard CRUD on every plan; public REST /v1 and MCP webhooks stay Growth+.

Redirects do not wait on your server. Delivery is async. Events are sampled (default about 1 in 10 after a small first-click burst). Dashboard webhook CRUD is available on every plan; public /v1/webhooks and MCP stay Growth+.

Register

Dashboard (any plan) or POST /v1/webhooks (Growth+) 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.