Flyhalf · Developer docs
Integration is an afternoon.
Your systems send events. Flyhalf runs your flows — awarding points, badges and prizes, moving leaderboards, and messaging people. These guides get you from a first signed event to results webhooked back into your app.
Getting started
Introduction
How Flyhalf turns events into engagement.
Quickstart
Fire your first signed event and award a badge in five minutes.
Authentication
API keys, abilities, live vs sandbox.
Sandbox mode
Test against real flows without touching customers.
Sending events
Events
The event convention and participant upsert.
Signing events
HMAC ingest endpoints and the X-Signature header.
Idempotency
Safe retries with idempotency keys.
Receiving results
Outbound webhooks
Subscribe to results and verify signatures.
Embeddable widgets
Drop leaderboards and badge showcases into any page.