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.