Documentation Index
Fetch the complete documentation index at: https://docs.grantiva.io/llms.txt
Use this file to discover all available pages before exploring further.
Webhooks are available on Pro, Business, and Enterprise plans.
1. Create an endpoint
In the dashboard, go to Settings > Webhooks and click Create Endpoint. Enter your HTTPS endpoint URL and select which events to listen for:| Event | Description |
|---|---|
device.new | First attestation from a new device |
device.high_risk | Device exceeds risk threshold |
device.attestation_failed | Attestation validation failed |
attestation.anomaly | Unusual attestation pattern |
whsec_...) — save this for signature verification.
2. Handle webhook events
3. Test your endpoint
From the webhook detail page in the dashboard, click Send Test Event. This fires awebhook.test event to verify your endpoint is reachable.
4. Verify it works
Check the delivery log in the dashboard. Each delivery shows:- HTTP status code
- Response body
- Delivery time
- Retry count
Retries
Failed deliveries (non-2xx response or timeout) are retried up to 3 times with exponential backoff:| Attempt | Delay |
|---|---|
| 1st retry | ~1 minute |
| 2nd retry | ~5 minutes |
| 3rd retry | ~30 minutes |
Next steps
- Webhooks concepts — signature verification in more languages
- Webhook API Reference — list, create, update, and delete endpoints programmatically