Complete guide to testing, debugging, and monitoring GitHub webhooks. Auto-detect push, PR, and issue events with signature verification and failure diagnosis.
curl -X POST https://webhook.sdnbros.app/p/YOUR_TOKEN \
-H "Content-Type: application/json" \
-H "X-GitHub-Event: push" \
-H "X-GitHub-Delivery: test-123" \
-d '{"ref":"refs/heads/main","repository":{"full_name":"yourorg/yourrepo"}}'
SDNBros auto-detects these GitHub events:
push pull_request issues issue_comment create delete release workflow_run check_run check_suite deployment deployment_status | Error | Cause | Fix |
|---|---|---|
HTTP 401 | X-Hub-Signature-256 verification failing | Ensure your webhook secret matches between GitHub and SDNBros |
Timeout | GitHub has a 10-second timeout for webhook delivery | Return 200 immediately, process the event asynchronously |
No events received | Wrong content type or events not selected | Set Content-Type to application/json and select the events you need |
sdnbros webhook tunnel --port 3000 forwards webhooks to localhostCreate an endpoint and evaluate auto-classification, diagnosis, and replay.
Start FreeSee also: GitHub Provider Details | Webhook Security Checklist | Free Webhook Tester