Overview

​

Setup

​

Event Ordering

​

Webhook Retries

​

Endpoint Backoff & Auto-Disable

​

How it works

1. Notification retries: Each notification is retried up to 12 times before being marked as permanently failed
2. Endpoint backoff: After a notification permanently fails (exhausts all retries), the endpoint enters a backoff period
3. Progressive delays: Each consecutive permanent failure increases the backoff duration
4. Auto-disable: After 6 consecutive permanent failures with no successful deliveries, the endpoint is automatically disabled
5. Reset on success: Any successful delivery immediately resets the backoff cycle to zero

• While in backing-off or disabled status, new events are queued (not lost)
• When you re-enable the endpoint, all queued events will be delivered
• You can re-enable an endpoint at any time via the Update webhook endpoint by setting status: "active"
• A successful delivery will reset the backoff cycle

​

Webhook Signing

​

Nodejs Example

import crypto from 'crypto'

const signature = Buffer.from(res.headers['slash-webhook-signature'], 'base64')
const body = Buffer.from(res.body)

// Both keys are published at /api-reference/public-rsa-key.
const keys = [CURRENT_PUBLIC_KEY, NEW_PUBLIC_KEY]

const result = keys.some((key) =>
  crypto.verify('sha256', body, key, signature)
)