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 onlyevents: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-Signatureon every request. - Answer with
2xxin under 15 seconds and do slow work in the background. - Store processed event IDs to skip duplicates.
- Return
410 Gonefrom endpoints you've retired so Relay stops sending.
Monitoring
Set up alerts in Settings → Notifications:
| Alert | Suggested threshold |
|---|---|
| Endpoint failure rate | Above 10% for 15 minutes |
| Endpoint disabled | Always |
| Queue delay | Above 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.