Events

8BALL delivers realtime platform events through signed webhooks. Your backend receives HTTP POST requests when subscribed events occur.

How delivery works

1. Create a webhook subscription in the developer console or via the Events API.
2. 8BALL sends a signed payload when a subscribed event occurs.
3. Failed deliveries are retried automatically with exponential backoff (up to five attempts).

Signing

Every delivery includes an 8ball-signature header. Verify the HMAC before processing the payload.

Retries

Failed deliveries retry up to five times with exponential backoff.

See Webhooks and Subscribe to Events for setup details.