Introduction

WebhookRelay is a powerful webhook routing platform that helps you receive, transform, and deliver webhooks reliably.

What is WebhookRelay?

WebhookRelay acts as a smart middleware for your webhooks. Instead of pointing webhooks directly at your applications, you point them at WebhookRelay, which then:

1. Receives webhooks from any source (GitHub, Stripe, Shopify, etc.)
2. Validates signatures to ensure authenticity
3. Transforms payloads to match your application's expected format
4. Filters events based on content or headers
5. Routes to one or more destinations
6. Retries failed deliveries automatically
7. Logs everything for debugging and analytics

Key Concepts

Sources

A Source is an endpoint that receives incoming webhooks. Each source has a unique URL:

https://api.hookbase.app/ingest/{orgSlug}/{sourceSlug}

You configure webhook providers (like GitHub or Stripe) to send webhooks to this URL.

Destinations

A Destination is where webhooks get delivered. This is typically your application's webhook handler URL. Destinations can have:

• Custom headers
• Authentication
• Retry policies

Routes

A Route connects sources to destinations. A single source can route to multiple destinations, and you can apply transforms and filters to control what gets delivered.

Transforms

Transforms are JavaScript functions that modify webhook payloads before delivery. Use them to:

• Reshape data to match your application's format
• Extract specific fields
• Add computed values
• Convert between formats

Filters

Filters control which webhooks get delivered based on conditions. For example:

• Only deliver push events from GitHub
• Only forward orders over $100
• Skip test/sandbox webhooks

Architecture

┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│   GitHub    │────▶│              │────▶│  Your App   │
└─────────────┘     │              │     └─────────────┘
                    │              │
┌─────────────┐     │  WebhookRelay│     ┌─────────────┐
│   Stripe    │────▶│              │────▶│   Slack     │
└─────────────┘     │              │     └─────────────┘
                    │              │
┌─────────────┐     │              │     ┌─────────────┐
│   Shopify   │────▶│              │────▶│  Database   │
└─────────────┘     └──────────────┘     └─────────────┘

Next Steps

• Quick Start - Get up and running in 5 minutes
• Sources - Learn about receiving webhooks
• Destinations - Configure where webhooks go
• Routes - Connect sources to destinations