RelayFox

How to test GitHub webhooks locally

Debug GitHub webhooks (pushes, PRs, issues) without deploying. Point a repo or org webhook at RelayFox and inspect every delivery.

  1. 1
    Create a free RelayFox URL on the homepage (no signup needed).
  2. 2
    Paste it as your webhook endpoint: Repository → Settings → Webhooks → Add webhook (or Organization settings).
  3. 3
    Trigger an event (e.g. push) and watch it arrive live in RelayFox.
  4. 4
    Run the CLI to forward captured events to your local server:
    npx relayfox forward <endpoint-id> --to http://localhost:3000 --token rfx_...
  5. 5
    Inspect headers, body and replay any event as many times as you need.

RelayFox preserves the X-Hub-Signature-256 header when forwarding, so GitHub's signature verification works against your local server unchanged.

Get your GitHub webhook URL