Subscribe to Events

Manage webhook subscriptions programmatically with the Events API.

Required scope: webhook:write

List Subscriptions

GET /v1/events/subscriptions

curl https://api.8ball.live/v1/events/subscriptions \
  -H "Authorization: Bearer 8b_at_..."

Create Subscription

POST /v1/events/subscriptions

curl -X POST https://api.8ball.live/v1/events/subscriptions \
  -H "Authorization: Bearer 8b_at_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/webhooks/8ball",
    "event_types": ["livestream.started", "chat.message.sent"],
    "description": "Production webhook"
  }'

The response includes a one-time signing_secret. Save it immediately.

Delete Subscription

DELETE /v1/events/subscriptions/:id

curl -X DELETE https://api.8ball.live/v1/events/subscriptions/subscription-id \
  -H "Authorization: Bearer 8b_at_..."

Returns 204 No Content on success.