Back to developer guide

Webhooks

Webhook simulation and event delivery

Use webhook simulation to validate receiver behavior. Production delivery requires final destination configuration and signing policy.

Delivery configuration

Webhook simulation is available to validate receiver behavior before production event delivery is enabled. Complete destination configuration, signing, and retry policy before relying on event delivery.

  • Use simulation to validate receiver behavior before enabling production delivery.
  • Store event identifiers and timestamps.
  • Complete production signing and retry policy before relying on delivery.

Test a webhook event

Send a simulated event to validate your receiver and downstream workflow.

curl -X POST https://review.getsunura.com/api/v1/webhooks/test \
  -H "x-sunura-api-key: $SUNURA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"eventType":"evidence.created","targetUrl":"https://example.com/sunura/webhook"}'

Receiver requirements

Your receiver should accept JSON, return a fast 2xx response, and process longer work asynchronously.