Skip to content
RelayDocumentation

GuidesGet started

Introduction

Relay delivers your webhooks reliably: signed, retried, logged and easy to debug.

Relay is a webhook delivery platform. Your application sends an event to Relay with one API call, and Relay delivers it to every endpoint that subscribed to it, with signatures, automatic retries and a full delivery log.

You don't need to build queues, retry schedules or a status page for your customers. Relay handles the delivery so you can focus on your product.

How it works

  1. Your customer adds an endpoint, for example https://api.acme.com/webhooks, and picks the event types they care about.
  2. Your application calls POST /v1/events whenever something happens, such as invoice.paid.
  3. Relay signs the payload, delivers it to every matching endpoint and retries failures with exponential backoff for up to three days.
  4. You and your customers can inspect every attempt in the dashboard or through the API.
Your app ──POST /v1/events──▶ Relay ──signed HTTPS──▶ Customer endpoints
                                 │
                                 └── retries, logs, alerts

Why teams use Relay

Build it yourselfRelay
Retries with backoffQueue, workers and a schedulerBuilt in, configurable per endpoint
SignaturesWrite and document your own schemeHMAC-SHA256 with timestamps, SDKs verify it
Delivery logsExtra tables and a UISearchable for 30 days, through the API too
Customer portalWeeks of front-end workEmbeddable portal, one line of code

New to webhooks?

Start with Events and Endpoints. They explain the two objects everything else is built on.