Webhooks

Webhooks allow you to receive real-time HTTP notifications when events occur in your Bold account.

Setting Up Webhooks

1. Go to your Bold dashboard
2. Navigate to Settings > Webhooks
3. Add your endpoint URL
4. Select the events you want to receive

Events

Payload Format

{
  "event": "video.processed",
  "timestamp": "2025-12-24T12:00:00Z",
  "data": {
    "video_id": "vid_123456",
    "status": "ready"
  }
}

Verifying Webhooks

All webhook payloads include a signature header for verification:

X-Bold-Signature: sha256=abc123...

Verify using HMAC SHA-256 with your webhook secret.