Webhooks

Webhooks let Veridox notify your systems automatically when something happens — so you can react to events without polling. You set them up on the Organisation tab in Settings, under Webhooks — available to the organisation owner.

This page covers setting one up in the dashboard. For the technical detail — the payload format, the event types, and how to verify the signature on incoming requests — see docs.veridox.ai.

Add a webhook

1. Under Webhooks, select Generate Webhook Secret (it reads Regenerate Webhook Secret once you already have one).
2. Give it a Name for the service it points at.
3. Enter the URL Veridox should send events to (for example https://example.com/webhook).
4. Optionally set an Expires At date, or leave it blank for no expiry.

Veridox then shows you a signing secret — used to confirm that incoming requests genuinely came from Veridox. It's shown once, with the warning:

Copy this secret now. You will not be able to see it again.

Use Copy secret to save it somewhere safe, then select Done.

Manage existing webhooks

Each webhook shows its Name, an Active or Inactive status, a masked preview of its secret, when it was Created, and when it Expires (or No expiry).

To remove one, select Delete and confirm — Veridox will stop sending events to that URL. To change a webhook's URL, delete it and add a new one.

ℹ️ Keep the signing secret private. Use it to verify every incoming request as described in the developer docs, so your endpoint only acts on genuine Veridox events.