Skip to main content
← Back to Quickstart Guides

Webhook Integration

Real-time event notifications

Available Events

  • stream.started - Stream went live
  • stream.ended - Stream stopped
  • recording.completed - Recording ready
  • billing.usage_updated - Usage threshold reached

Configure Webhook

Register your webhook endpoint via the dashboard or API:

POST /api/v1/webhooks

{
  "url": "https://your-server.com/webhooks/wave",
  "events": ["stream.started", "stream.ended"],
  "secret": "your_webhook_secret"
}

// Verify signatures using HMAC-SHA256
const signature = crypto
  .createHmac('sha256', secret)
  .update(JSON.stringify(payload))
  .digest('hex');
Webhooks - Quickstart | WAVE Docs | WAVE