generated: '2026-10-19'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://docs.zespan.com/guides/webhooks.md
sources:
- https://docs.zespan.com/guides/webhooks.md
- https://docs.zespan.com/api-reference/ingestion/ingest-trace-events.md
description: Zespan alert webhooks fire when an alert rule breaches a configured threshold.
events:
- event: alert.fired
  description: Sent when an alert rule fires, containing details about the rule, metric, threshold, current value, and a signature for verification.
delivery:
  signature: 'HMAC-SHA256 of the raw request body using the webhook secret, provided in the payload field "signature" and also in the header "X-Zespan-Signature"
    (format: sha256=<hex_digest>)'
  retries: 3 attempts with exponential backoff (5 s, 25 s, 125 s)
  content_type: application/json
note: Webhooks are only available on the Scale plan; Pro and Team plans have email notifications only.
docs: https://docs.zespan.com/guides/webhooks.md