@sylphx/webhookbin-cli

WebhookBin CLI

Forward webhooks from WebhookBin to your local development server. Similar to ngrok, but specifically designed for webhook testing.

Installation

npm install -g webhookbin-cli

Or use directly with npx:

npx webhookbin-cli --slug my-bin --api-key xxx --forward http://localhost:3000

Usage

webhookbin --slug <bin-slug> --api-key <api-key> --forward <local-url>

Options

Option	Short	Description	Required
--slug	-s	Your bin's slug	Yes
--api-key	-k	API key for authentication	Yes
--forward	-f	Local URL to forward webhooks to	Yes
--host	-h	WebhookBin host (default: webhookbin.app)	No
--verbose	-v	Enable verbose logging	No
--help		Show help message	No

Example

# Forward webhooks to your local Express server
webhookbin --slug my-webhook-bin --api-key abc123 --forward http://localhost:3000/webhook

# With verbose logging
webhookbin -s my-bin -k abc123 -f http://localhost:8080/api/webhook -v

Environment Variables

You can also configure the CLI using environment variables:

Variable	Description
WEBHOOKBIN_HOST	Override default host
WEBHOOKBIN_API_KEY	Default API key
WEBHOOKBIN_FORWARD_URL	Default forward URL

How It Works

1. Connect: The CLI establishes a Server-Sent Events (SSE) connection to WebhookBin
2. Wait: When a webhook arrives at your bin, WebhookBin pushes it to the CLI
3. Forward: The CLI forwards the request to your local server
4. Respond: Your local server processes the webhook normally

Webhook Provider → WebhookBin → CLI → Your Local Server

Benefits

• No SSRF risk: Requests are made from your machine, not WebhookBin's servers
• Full request data: Headers, body, query params are all forwarded
• Real-time: Instant forwarding via SSE
• Automatic reconnection: CLI reconnects if connection drops

Getting Your API Key

1. Go to your bin's settings page on WebhookBin
2. Enable "Forwarding" in the settings
3. Copy the API key shown in the settings

Output

The CLI shows real-time webhook activity:

[14:23:45] Connecting to webhookbin.app...
[14:23:46] Connected! Waiting for webhooks...
[14:23:46] Forwarding to: http://localhost:3000/webhook

[14:24:01] POST   /webhook 200 (45ms)
[14:24:15] POST   /webhook/event 201 (32ms)
[14:24:30] GET    /health 200 (5ms)

License

MIT