Hookbase
Docs
GuideAPI ReferenceIntegrationsUse CasesCLIMCP
Getting StartedSDK ReferencePortal ComponentsAPI Reference
Get Started

Getting Started

OverviewIntegration Guide

SDK & Portal

SDK ReferencePortal OverviewMagic LinksComponentsHooksStylingPortal API Reference

API Reference

REST API
DocsSend

Send Webhooks

Hookbase helps you build webhook infrastructure for your customers. Instead of building webhook delivery from scratch, use our SDK and Portal to provide a polished webhook experience.

What You Get

  • Reliable Delivery - Automatic retries, exponential backoff, and dead letter queues
  • Customer Portal - Embeddable React components for endpoint management
  • Event Types - Define and organize the events your customers can subscribe to
  • Signature Verification - HMAC-SHA256 signatures for secure webhooks
  • Delivery Logs - Full visibility into delivery attempts and failures

Architecture

Your Application                    Hookbase                     Your Customer
┌─────────────┐                   ┌─────────────┐               ┌─────────────┐
│             │  Send webhook     │             │  Deliver      │             │
│   Backend   │ ─────────────────▶│     API     │──────────────▶│  Endpoint   │
│             │  via SDK          │             │               │             │
└─────────────┘                   └─────────────┘               └─────────────┘
                                         │
                                         │
┌─────────────┐                   ┌─────────────┐
│             │  Embed portal     │             │
│  Frontend   │ ◀─────────────────│   Portal    │
│             │  components       │             │
└─────────────┘                   └─────────────┘

Quick Start

1. Install the SDK

npm install @hookbase/sdk

2. Send Your First Webhook

import { Hookbase } from '@hookbase/sdk';
 
const hookbase = new Hookbase({
  apiKey: process.env.HOOKBASE_API_KEY,
});
 
// Create an application for your customer
const app = await hookbase.applications.create({
  name: 'Acme Corp',
  uid: 'customer_123',
});
 
// Send a webhook
await hookbase.messages.send(app.id, {
  eventType: 'order.created',
  payload: {
    orderId: 'ord_123',
    amount: 99.99,
  },
});

3. Embed the Portal

import { HookbasePortal, EndpointList, EndpointForm } from '@hookbase/portal';
import '@hookbase/portal/styles.css';
 
function WebhookSettings({ portalToken }) {
  return (
    <HookbasePortal token={portalToken}>
      <EndpointForm />
      <EndpointList />
    </HookbasePortal>
  );
}

Next Steps

Getting Started

Complete integration guide with step-by-step instructions

SDK Reference

Full API documentation for @hookbase/sdk

Portal Components

Embeddable React components for customer-facing UI

API Reference

REST API endpoints for advanced integrations

NextIntegration Guide

On this page

What You GetArchitectureQuick Start1. Install the SDK2. Send Your First Webhook3. Embed the PortalNext Steps