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-Signature header, an HMAC-SHA256 of the body using your endpoint secret. Verify it in one line with relay.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

AddedADD3232230
ImprovedIMP2100220
FixedFIX0020203
BreakingBRK0102000