Revision1.2.0Superseded
Webhooks are generally available
Outbound webhooks leave beta with signed payloads, automatic retries, and a delivery inspector in the dashboard.
- Released
- Date code
- 2626
- Changes
- 5
Webhooks have been in beta since 0.9.0, and after four months of feedback they are now generally available for every plan.
Added
- Signed payloads. Every delivery now carries an
X-Relay-Signatureheader, an HMAC-SHA256 of the body using your endpoint secret. Verify it in one line withrelay.webhooks.verify(payload, signature, secret). - Delivery inspector. The dashboard shows the last 30 days of deliveries per endpoint, with request and response bodies, timing, and a one-click redeliver button.
- Event filtering. Subscribe an endpoint to specific event types instead of the whole firehose. Existing endpoints keep receiving everything until you edit them.
Improved
- Retries now use exponential backoff with jitter (up to 8 attempts over 24 hours) instead of three fixed retries. Dead deliveries surface in the inspector with the final failure reason.
- Endpoint secrets can be rotated without downtime: both the old and new secret validate for 24 hours after rotation.
Upgrade with npm install @relay/sdk@1.2 or see the configuration guide for the new webhooks block.
Cursor at v1.2.0 · every revision