# Add a webhook endpoint

Webhooks push events from Orvoro to a URL you control, so your systems can react in real time.

## Steps

1. Go to **Webhooks** in your dashboard and click **Add webhook**.
2. Enter your **endpoint URL** (must be publicly reachable over HTTPS).
3. Choose the **events** to send.
4. Save the **signing secret** — use it to verify each request really came from Orvoro.
5. Use **Send test event** to confirm your endpoint receives it. Check the **delivery log** and **retry** failed deliveries.

## Verify signatures

Each request is signed with your secret. Recompute the signature on your server and compare before trusting the payload.

## Troubleshooting

- **Deliveries failing** — your endpoint must return a 2xx quickly; check it's reachable and not blocking Orvoro's IPs.
- **Signature mismatch** — ensure you're hashing the raw request body with the exact secret.

**Related:** Create and manage API tokens · Route form submissions