Webhooks

Webhooks let you receive real-time event notifications from Fanzava in your own systems: CRMs, data warehouses, Slack bots, or custom applications.

Available events

Event	Triggered when
participant.joined	A participant joins your hub
participant.first_tip	A participant submits their first tip
participant.inactive	A participant misses 2+ rounds
round.locked	A round’s first fixture locks
round.scored	A round’s results are fully scored
round.leaderboard_updated	Leaderboard positions change after scoring
competition.started	A competition’s first round begins
competition.ended	A competition’s final round is scored
group.member_added	A participant is added to a group

Setting up a webhook

1. Go to Admin → Integrations → Webhooks → New webhook
2. Enter your endpoint URL (must be HTTPS)
3. Select which events to subscribe to
4. Optionally set a secret key for signature verification
5. Click Create

Fanzava sends a test event to your endpoint immediately. If it returns HTTP 200, the webhook is active.

Payload format

All events use the same envelope:

{
  "event": "round.scored",
  "hub_id": "hub_abc123",
  "timestamp": "2026-04-01T10:30:00Z",
  "data": {
    // Event-specific payload
  }
}

Signature verification

If you set a secret key, Fanzava includes an X-Fanzava-Signature header on every request:

X-Fanzava-Signature: sha256=<HMAC-SHA256 of request body using your secret>

Verify this signature in your endpoint to ensure requests are genuinely from Fanzava.

Retries and failures

If your endpoint returns a non-2xx status or times out (>10 seconds), Fanzava retries up to 5 times with exponential backoff. Failed delivery attempts are logged in Admin → Integrations → Webhooks → [Webhook] → Delivery log.

i

Note

Webhook endpoints must respond within 10 seconds. For time-consuming processing, accept the webhook immediately (return 200) and handle the payload asynchronously.