Debugging playbook

Webhook Delivery Failure

Use when a webhook event, attempt, replay, or delivery span fails.

Linked toolsok
3
Source: playbook registry
Updated: 5/25/2026, 5:11:10 PM
Evidence/query
Commandsok
2
Source: playbook registry
Updated: 5/25/2026, 5:11:10 PM
Evidence/query
WebhookLabTraceSandbox
Symptoms
  • webhooks span failed.
  • Delivery attempt has error code.
  • Replay span is protected or degraded.
Likely Causes
  • Receiver returned non-2xx.
  • Payload validation failed.
  • Replay requires PLATPHORM_API_KEY.
Checks
  • Inspect webhook delivery evidence.
  • Check attempt count and status.
  • Verify secrets were redacted.
Evidence To Collect
  • event ID
  • delivery ID
  • attempt status
  • redacted response summary
platphormctl Commands
platphormctl trace get <traceId>
platphormctl trace report <traceId>