Quickstart

Get your API key

Go to Settings > API Keys and create a new key with Admin scope.

For a fast first walkthrough, one admin key is enough for every step below. In production, use an ingest key for events and keep your admin key only on a trusted backend for dashboard and embed-session calls.

Copy the key — it's shown only once.

Send your first event

curl -X POST https://emban.sidelabs.dev/v1/events \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "events": [{
    "tenant_id": "customer_1",
    "event_name": "api.call",
    "timestamp": "2026-03-29T12:00:00Z",
    "user_id": "user_1",
    "string_props": {"endpoint": "/chat", "model": "gpt-4"},
    "numeric_props": {"tokens": 150, "latency_ms": 230}
  }]
}'

Response: {"accepted":1,"status":"ok"}

Auto-create a customer dashboard

curl -X POST https://emban.sidelabs.dev/v1/discover/auto-create \
  -H "Authorization: Bearer YOUR_API_KEY"

Emban scans your events and generates a tenant-scoped dashboard with KPIs, trends, and customer-facing breakdowns.

Publish the dashboard

Dashboards start as drafts. Publish to make it available via embed:

curl -X POST https://emban.sidelabs.dev/v1/dashboards/YOUR_DASHBOARD_ID/publish \
  -H "Authorization: Bearer YOUR_API_KEY"

Use the dashboard_id from step 3.

Create a signed tenant-scoped session

From your backend, create a short-lived signed session for the customer viewing the published dashboard. This is an admin-scoped action and the tenant boundary for the embedded analytics surface:

curl -X POST https://emban.sidelabs.dev/v1/embed-sessions \
  -H "Authorization: Bearer YOUR_ADMIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "tenant_id": "customer_1",
  "dashboard_id": "YOUR_DASHBOARD_ID",
  "expires_in": 3600
}'

Response includes embed_url — a signed URL valid for 1 hour.

That URL is scoped to tenant_id=customer_1 and the published dashboard_id, so the embedded dashboard shows only that customer's data.

Embed in your app

Option A: iframe

<iframe src="EMBED_URL" width="100%" height="600"
  style="border:none; border-radius:4px"></iframe>

Option B: browser helper for resize and programmatic control around the tenant-scoped embed

<div id="analytics"></div>
<script src="https://emban.sidelabs.dev/sdk/emban-embed.js"></script>
<script>
  const dash = Emban.create({
    container: '#analytics',
    embedUrl: 'EMBED_URL'
  });
  dash.on('ready', () => console.log('Dashboard loaded'));
</script>

Option C: React wrapper for the signed iframe path if your frontend already uses React or Next.js

import { EmbanEmbedFrame } from '@emban/embed-helper/react';

<EmbanEmbedFrame
  embedUrl="EMBED_URL"
  containerStyle={{ minHeight: 600 }}
/>

If you need native widget-level composition instead of a mounted iframe surface, continue with the React guide and @emban/react.

The browser helper and iframe React wrapper handle auto-resize, theme sync, and runtime session swapping, but the signed tenant-scoped session is still the core integration boundary.