Webhook Catcher CLI

Catch webhooks from Stripe, GitHub, Discord, Midtrans, Slack, Shopify, Telegram, and more no adapters needed.

A tiny CLI to spin up a local HTTP server that logs every incoming request (method, headers, body) with pretty‑printed JSON. Optionally expose it to the internet using an ngrok tunnel and get a public URL instantly.

Features

• Simple HTTP listener on your machine

• Pretty‑prints JSON request bodies

• Shows method, path, and sorted headers

• Optional ngrok tunneling (choose from interactive menu)

• Interactive ngrok onboarding: if needed, you’ll be prompted for the token and it’s stored automatically for next runs

• Small, single‑binary distribution

• Works with Stripe, GitHub, Discord, Midtrans, Slack, Shopify, Telegram, and more

Works with any provider

This tool is a generic webhook catcher. No plugins or adapters are required it prints method, path, sorted headers (e.g., Stripe-Signature, X-GitHub-Event), and prettified JSON bodies. It works great with Stripe, GitHub, Discord, Midtrans, Slack, Shopify, Telegram, and more.

Requirements

• Go 1.21+
• (Optional) ngrok account if you want tunneling

Releases

• Latest: https://github.com/0xReLogic/webhook-catcher-cli/releases/latest
• All releases: https://github.com/0xReLogic/webhook-catcher-cli/releases

Download (Windows, Linux, macOS)

Quick start:

• Windows (PowerShell):

.\webhook-catcher-cli.exe

• macOS / Linux:

chmod +x ./webhook-catcher-cli
./webhook-catcher-cli

Install

# From source
git clone https://github.com/0xReLogic/webhook-catcher-cli.git
cd webhook-catcher-cli
go build -o webhook-catcher-cli

# Or install directly
# go install github.com/0xReLogic/webhook-catcher-cli@latest

Usage

One‑click / Interactive start

If you launch the binary without arguments (e.g., double‑click on Windows), the app will show a simple menu:

Select mode: [1] Local (default)  [2] Tunnel (ngrok)
Enter 1 or 2 (default 1):

• Choose 1 to run locally on 127.0.0.1:3000.
• Choose 2 to enable ngrok. If needed, you’ll be guided to the ngrok dashboard to copy your token, then paste it once. We store it automatically for future runs.

Send sample requests:

# JSON
curl -i -X POST http://127.0.0.1:3000/test -H "Content-Type: application/json" --data '{"hello":"world"}'

# Plain text
curl -i -X POST http://127.0.0.1:3000/echo -H "Content-Type: text/plain" --data "hello webhook"

Build and Run

To run from source:

go build -o webhook-catcher-cli
# Start the app (interactive menu will appear, choose 1 for local or 2 for tunnel)
go run .

Star History

Milestone:

• If this project reaches 100+ GitHub stars, I'll build and host a simple tunnel server on my own VPS so this CLI no longer depends on ngrok.

Quick Provider Testing (Postman)

Use this ready-to-run Postman Collection to quickly test common providers. The collection uses a baseUrl variable so you can easily switch tunnels.

Steps:

• Import the collection below into Postman (Import > Raw text).
• Set the collection variable baseUrl to your tunnel, e.g. https://<YOUR_TUNNEL_URL>.
• Send the requests; this CLI will print method, path, headers, and body.

Postman Collection (v2.1):

{
  "info": {
    "name": "Webhook Catcher - Quick Provider Testing",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    { "key": "baseUrl", "value": "https://<YOUR_TUNNEL_URL>" }
  ],
  "item": [
    {
      "name": "GitHub - Issues Webhook",
      "request": {
        "method": "POST",
        "header": [
          { "key": "Content-Type", "value": "application/json" },
          { "key": "X-GitHub-Event", "value": "issues" }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"action\": \"opened\",\n  \"issue\": {\n    \"number\": 1347,\n    \"title\": \"Found a critical bug!\",\n    \"user\": { \"login\": \"0xReLogic\" }\n  },\n  \"repository\": { \"full_name\": \"0xReLogic/Helios\" }\n}"
        },
        "url": { "raw": "{{baseUrl}}/github-webhook", "host": ["{{baseUrl}}"], "path": ["github-webhook"] }
      }
    },
    {
      "name": "Discord - Notification",
      "request": {
        "method": "POST",
        "header": [ { "key": "Content-Type", "value": "application/json" } ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"username\": \"Server Notif Bot\",\n  \"avatar_url\": \"https://i.imgur.com/4M34hi2.png\",\n  \"content\": \"Warning! Production CPU usage reached 95%!\",\n  \"embeds\": [\n    {\n      \"title\": \"Metric Details\",\n      \"color\": 15258703,\n      \"fields\": [\n        { \"name\": \"Server ID\", \"value\": \"prod-web-01\", \"inline\": true },\n        { \"name\": \"CPU Usage\", \"value\": \"95.2%\", \"inline\": true }\n      ]\n    }\n  ]\n}"
        },
        "url": { "raw": "{{baseUrl}}/discord-notif", "host": ["{{baseUrl}}"], "path": ["discord-notif"] }
      }
    },
    {
      "name": "Midtrans - Payment Notification",
      "request": {
        "method": "POST",
        "header": [ { "key": "Content-Type", "value": "application/json" } ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"transaction_time\": \"2025-08-14 17:35:00\",\n  \"transaction_status\": \"settlement\",\n  \"transaction_id\": \"a1b2c3d4-e5f6-7890-1234-567890abcdef\",\n  \"status_message\": \"midtrans payment notification\",\n  \"status_code\": \"200\",\n  \"signature_key\": \"xxxxxxxxxxxxxxxxxxxxxxxx\",\n  \"payment_type\": \"gopay\",\n  \"order_id\": \"ORDER-101-XYZ\",\n  \"merchant_id\": \"G123456789\",\n  \"gross_amount\": \"50000.00\",\n  \"fraud_status\": \"accept\",\n  \"currency\": \"IDR\"\n}"
        },
        "url": { "raw": "{{baseUrl}}/midtrans-callback", "host": ["{{baseUrl}}"], "path": ["midtrans-callback"] }
      }
    },
    {
      "name": "Stripe - payment_intent.succeeded",
      "request": {
        "method": "POST",
        "header": [
          { "key": "Content-Type", "value": "application/json" },
          { "key": "Stripe-Signature", "value": "t=1723650000,v1=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"evt_test_123\",\n  \"type\": \"payment_intent.succeeded\",\n  \"created\": 1723650000,\n  \"livemode\": false,\n  \"data\": {\n    \"object\": {\n      \"id\": \"pi_123\",\n      \"amount\": 5000,\n      \"currency\": \"usd\",\n      \"status\": \"succeeded\"\n    }\n  }\n}"
        },
        "url": { "raw": "{{baseUrl}}/stripe-webhook", "host": ["{{baseUrl}}"], "path": ["stripe-webhook"] }
      }
    }
  ]
}

Examples

Stripe (payment_intent.succeeded)

Sample capture of a Stripe payment_intent.succeeded event received via tunnel:

PowerShell response example (Invoke-WebRequest output):

Quick send examples (Stripe & Discord only)

Use your current tunnel URL as <PUBLIC_URL> (from the app output: "Public URL: https://xxxxx.ngrok-free.app").

• PowerShell

# Stripe
$URL = "https://<PUBLIC_URL>/stripe-webhook"
Invoke-WebRequest -Method POST -Uri $URL -ContentType "application/json" -Headers @{ "Stripe-Signature"="t=1723650000,v1=aaaa" } -Body '{
  "id":"evt_test_123",
  "type":"payment_intent.succeeded",
  "data": { "object": { "id":"pi_123","amount":5000,"currency":"usd","status":"succeeded" } }
}'

# Discord
$URL = "https://<PUBLIC_URL>/discord-webhook"
Invoke-WebRequest -Method POST -Uri $URL -ContentType "application/json" -Body '{
  "id":"1234567890",
  "type":"MESSAGE_CREATE",
  "content":"Hello from Discord webhook simulator",
  "channel_id":"987654321"
}'

• Bash

# Stripe
curl -i -X POST "https://<PUBLIC_URL>/stripe-webhook" \
  -H "Content-Type: application/json" \
  -H "Stripe-Signature: t=1723650000,v1=aaaa" \
  --data '{
    "id":"evt_test_123",
    "type":"payment_intent.succeeded",
    "data":{"object":{"id":"pi_123","amount":5000,"currency":"usd","status":"succeeded"}}
  }'

# Discord
curl -i -X POST "https://<PUBLIC_URL>/discord-webhook" \
  -H "Content-Type: application/json" \
  --data '{
    "id":"1234567890",
    "type":"MESSAGE_CREATE",
    "content":"Hello from Discord webhook simulator",
    "channel_id":"987654321"
  }'

Development

go fmt ./...
go vet ./...
go test ./...
go run . -port 3001

License

MIT

---

Made with ❤️ Allen Elzayn