All guides
Getting started · 5 min

Quickstart

Authenticate, send a usage event, and watch it appear in the dashboard in real time.

The entire integration is one event stream. Send Kribana what your product does; everything else — pricing, invoices, wallets, the portal — is configured in the dashboard, not coded.

1 · Get your API key

Create a workspace and copy your secret key from Dashboard → Developers → API keys. Test-mode keys are prefixed kb_test_ and bill nothing.

2 · Send your first event

One POST per usage moment. Events appear in the dashboard's live feed within a second, aggregated per customer.

curl https://api.kribana.com/v1/events \
  -H "Authorization: Bearer $KRIBANA_KEY" \
  -d '{
    "customer": "acme_labs",
    "event": "gpt4o.completion_tokens",
    "quantity": 48120,
    "idempotency_key": "evt_8842"
  }'

Unknown event names are accepted and flagged — you can wire pricing to them later without losing history.

3 · That's the integration

Everything from here on happens in the dashboard: attach prices to events, create plans, brand the portal, connect a processor. Your GTM team takes it from this point without another deploy.

Next: Authentication

Bearer tokens, test vs live environments, and key rotation.