Provider guide
HookTrace for GitHub webhooks
Capture GitHub webhook deliveries with full headers and payloads, and replay failures on demand.
HookTrace keeps every GitHub event durable and searchable, so you can debug signature errors and webhook retries in minutes.
Setup
Route GitHub webhooks through HookTrace
Use your HookTrace proxy URL in the provider dashboard, then keep your existing handler as the target URL.
Create a GitHub endpoint in HookTrace
Name it “GitHub Webhooks” and set your target URL to your GitHub handler.
Set the GitHub webhook URL
In GitHub → Settings → Webhooks, use https://api.katsuralabs.com/ingest/{endpointId}.
Add X-HookTrace-Secret header
Use the HookTrace secret token. HookTrace forwards GitHub headers and raw payload.
Why HookTrace
Built for GitHub delivery incidents
Durable ingest, full payload visibility, and replay controls give you confidence when webhook deliveries fail.
Preserve GitHub headers
X-GitHub-Event and signature headers are forwarded intact.
Replay any delivery
Retry GitHub deliveries without re-registering a webhook.
Incident-ready logs
Get latency, response status, and error details per delivery.
Share redacted events
Share payloads with collaborators safely via time-limited links.
Coming soon
Get early access to HookTrace
Join the waitlist and be first to know when we launch.