Webhooks API

Receive real-time event notifications via HTTP POST to your endpoints.

Events

room.started

A room became active (first participant joined)

room.ended

A room ended (all participants left)

participant.joined

A participant joined a room

participant.left

A participant left a room

recording.started

A recording started

recording.complete

A recording finished and is ready to download

Payload format

{
  "id": "evt_uuid",
  "type": "room.started",
  "tenantId": "uuid",
  "createdAt": "2025-01-01T00:00:00Z",
  "data": { /* event-specific data */ }
}

Signature verification

Each request includes a X-RelayKit-Signature header containing an HMAC-SHA256 signature. Verify it with your endpoint's secret.