← Back to all guides

Workspace & account

Webhooks

What it's for

Push events (e.g. crawl completed, alert raised) to your own URL in real time. Deliveries are HMAC-signed, retried with backoff, de-duplicated, and kept with a full delivery history.

When to use it

  • To trigger your own automation when a crawl finishes.
  • To forward alerts into Slack/Teams/PagerDuty via a receiver.

How to use it

  1. Organization → «Webhooks»; add an endpoint URL and pick events.
  2. Verify the HMAC signature on your receiver using the shown secret.
  3. Watch the delivery history for failures.

Reading your results

For each output: is it good, does it need improvement, or is it bad — and exactly what to do next.

Delivery status

Good Succeeded: your receiver returned 2xx.
Needs improvement Pending/retrying: transient failure; backoff will retry.
Bad Dead-lettered: exhausted retries — your endpoint is down or rejecting.

Next steps

  • Always verify the signature before trusting a payload.
  • Make your receiver idempotent — retries may deliver twice.
An unhandled error has occurred. Reload 🗙

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.