Installation

Coming soon

UseBetter Webhooks is under active development. Package names and exports shown below reflect the planned API and may change before release.

Prerequisites

• Node.js 22+ (also supports Bun and Deno)
• PostgreSQL 13+, MySQL, or SQLite
• TypeScript 5+ (recommended, but not required)
• An existing application with a supported ORM and framework

Install the package

npm

npm install @usebetterdev/webhooks

pnpm

pnpm add @usebetterdev/webhooks

yarn

yarn add @usebetterdev/webhooks

bun

bun add @usebetterdev/webhooks

The main package (@usebetterdev/webhooks) includes the core library and all adapters via subpath exports. The CLI (@usebetterdev/webhooks-cli) is used via npx for generating migrations and managing webhook data — no installation required.

Peer dependencies

You need a database driver and (optionally) a framework. Install the ones you use:

ORM adapter

Drizzle + pg

npm install drizzle-orm pg

import { drizzleWebhookAdapter } from "@usebetterdev/webhooks/drizzle";

Drizzle + postgres.js

npm install drizzle-orm postgres

import { drizzleWebhookAdapter } from "@usebetterdev/webhooks/drizzle";

Drizzle + better-sqlite3

npm install drizzle-orm better-sqlite3

import { drizzleWebhookAdapter } from "@usebetterdev/webhooks/drizzle";

Prisma

npm install @prisma/client

Requires @prisma/client >= 5.0.0.

import { prismaWebhookAdapter } from "@usebetterdev/webhooks/prisma";

Kysely

npm install kysely pg

import { kyselyWebhookAdapter } from "@usebetterdev/webhooks/kysely";

Framework adapter

Hono

npm install hono

Requires hono >= 4.

import { betterWebhooksHono } from "@usebetterdev/webhooks/hono";

Express

npm install express

Requires express >= 4.

import { betterWebhooksExpress } from "@usebetterdev/webhooks/express";

Next.js

Next.js is already installed in your project.

import { betterWebhooksNext } from "@usebetterdev/webhooks/next";

Run migrations

The CLI reads your database connection from the DATABASE_URL environment variable. After installing, run it to create the required database tables:

npx @usebetterdev/webhooks-cli migrate

Example output (may vary)

✔ Connected to database
✔ Created table: webhook_events
✔ Created table: webhook_endpoints
✔ Created table: webhook_deliveries
✔ Migrations complete

Connection issues?

If the command fails, verify that DATABASE_URL is set in your environment and that the database is running and reachable.

Peer dependency reference

Adapter	Peer dependency	Minimum version
@usebetterdev/webhooks/drizzle	drizzle-orm	0.30+
@usebetterdev/webhooks/drizzle	pg or postgres or better-sqlite3	—
@usebetterdev/webhooks/prisma	@prisma/client	5.0.0
@usebetterdev/webhooks/kysely	kysely	0.27+
@usebetterdev/webhooks/kysely	pg	—
@usebetterdev/webhooks/hono	hono	4.0.0
@usebetterdev/webhooks/express	express	4.0.0
@usebetterdev/webhooks/next	next	14.0.0

Next steps

Quick Start Send your first webhook event.