simplehook / simplehook-hono

One line of code. Webhooks just work.

Stop tunneling. Stop polling. Stop building webhook infrastructure. Add one SDK call and your local app receives real webhooks from Stripe, GitHub, Twilio — any provider.

listenToWebhooks(app, process.env.SIMPLEHOOK_KEY);

Your app opens an outbound WebSocket to simplehook.dev. When a webhook arrives at your stable URL, it's forwarded through the connection to your local server. Your response goes back to the caller. No CLI. No tunnel process. No URL that changes every session.

Why simplehook?

• No CLI — just npm install and one function call
• Permanent URLs — set once in Stripe/GitHub, never change them
• Real responses — passthrough mode returns your actual response to the caller (TwiML, verification, etc.)
• Queue + retry — if your app is offline, events queue and deliver when you reconnect
• Dev mode by default — only connects in development, never in production

Install

npm install simplehook-hono

Quick start

import { Hono } from "hono";
import { listenToWebhooks } from "simplehook-hono";

const app = new Hono();

listenToWebhooks(app, process.env.SIMPLEHOOK_KEY);

app.post("/stripe/events", async (c) => {
  const body = await c.req.json();
  console.log("Webhook received!", body);
  return c.json({ received: true });
});

export default app;

Options

listenToWebhooks(app, apiKey, {
  forceEnable: false,     // Connect even in production
  serverUrl: "...",       // Override server URL
  onConnect: () => {},    // Called when connected
  onDisconnect: () => {}, // Called when disconnected
  silent: false,          // Suppress console output
});

Agents

Use agents to run multiple SDK instances and route events to specific ones. Create agents in the dashboard, then assign them to routes.

// This instance only receives events from routes assigned to "staging"
listenToWebhooks(app, process.env.SIMPLEHOOK_KEY, "staging");

Your webhook URL stays the same — event routing is configured in the dashboard, not the URL.

Dev mode

By default, simplehook only connects in development. Set SIMPLEHOOK_ENABLED=false to disable, or forceEnable: true to force.

Production is detected when NODE_ENV === "production".

Links

• GitHub

• Documentation

• Dashboard

License

MIT