Webhooks

Webhooks allow your application to receive real-time notifications when events occur in HotMic. They work by sending HTTP POST requests to endpoints you configure.

How Webhooks Work

1. You configure an endpoint URL in HotMic's webhook settings.
2. When a subscribed event occurs, HotMic sends a POST request to your endpoint with the event payload.
3. Your endpoint processes the event and returns a 2xx response within 15 seconds to confirm receipt.

If your endpoint does not respond with a success status code, HotMic will retry delivery with exponential backoff.

Important: Disable CSRF protection for your webhook endpoint if your framework enables it by default.

Available Event Types

Stream Events

| Event | Description | |-------|-------------| | stream.created | A new stream has been created | | stream.live_countdown | A stream's live countdown has started | | stream.ended | A stream has ended |

Moderation Events

| Event | Description | |-------|-------------| | user.blocked | A user has been blocked from a stream |

Webhook Security

Every webhook is signed with a unique key for each endpoint. Always verify webhook signatures before processing them to prevent unauthorized requests.

Getting Started

1. Add an endpoint — Configure your URL and select event types.
2. Verify signatures — Validate that webhooks come from HotMic.
3. Monitor delivery — Track webhook delivery status and debug issues.
4. Replay messages — Recover from downtime by replaying missed events.

HotMic webhooks are powered by Svix.