Webhooks
Subscribe to scan, case, and verdict events. Plurall AI signs every delivery.
POST/api/v1/webhooks
curl -X POST https://api.plurall.tech/api/v1/webhooks \
-H "Authorization: Bearer $PLURALL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com/plurall/webhooks","description":"Production intake","events":["scan.completed","verdict.synthetic"]}'- Operation
- Create a webhook endpoint
- Scopes
- webhooks:manage
- Request
- WebhookCreateRequest
- Response
- 201 WebhookIssueResponse
Webhooks are the recommended pattern for high-volume integrations. Plurall AI delivers each event at-least-once and signs every payload with HMAC-SHA256 over the body using the secret you set when the endpoint was created.
Creating an endpoint
In Integrations -> Webhooks, choose an endpoint URL and a list of events. Plurall AI returns the signing secret once. Store it in your secret manager and never echo it back to the dashboard.
Verifying the signature
Each request carries Plurall-Signature: t=<unix>, v1=<hex>. Compute HMAC-SHA256 over ${t}.${body} using the signing secret and compare it to v1 in constant time. Reject the request if t is more than five minutes old.
Retries
We retry failed deliveries with exponential backoff up to 6 attempts over 24 hours. Use the deliveries view in Integrations -> Webhooks to inspect the full attempt history per delivery id.