Skip to content
RelayDocumentation

GuidesGuides

Going to production

A checklist for switching from test mode to live webhooks.

Before you send live events, walk through this checklist.

Sending side

  • Use a live key (rk_live_) stored in your secrets manager, with only events:write.
  • Pass an idempotency key built from your own data on every send.
  • Send events after your database transaction commits, never inside it.
  • Keep payloads small. Send IDs and the fields consumers need, not whole records.

Receiving side

  • Verify the Relay-Signature on every request.
  • Answer with 2xx in under 15 seconds and do slow work in the background.
  • Store processed event IDs to skip duplicates.
  • Return 410 Gone from endpoints you've retired so Relay stops sending.

Monitoring

Set up alerts in Settings → Notifications:

AlertSuggested threshold
Endpoint failure rateAbove 10% for 15 minutes
Endpoint disabledAlways
Queue delayAbove 5 minutes

You can also forward Relay's own events (endpoint.disabled, delivery.failed) to Slack or PagerDuty by subscribing an endpoint to relay.*.

Ship a status page for your customers

The embeddable portal shows each customer their endpoints, recent deliveries and failures, so they can debug without opening a ticket.