Quickstart

This guide takes you from zero to your first tracked event against production (https://api.logga.sh). If you're running Logga locally instead, swap the base URL for http://localhost:3000 — see Local Development.

1. Create an account

Sign up from the Logga iOS app or the web dashboard. Registration creates:

• your user,
• a workspace (with production and sandbox environments),
• a default project called General.

2. Get an API key

API keys authenticate event ingestion and are scoped to one workspace + environment.

• iOS app: Settings → API Keys → Create API key. Tap How to send events for copy-paste snippets pre-filled with your key.
• Dashboard: Settings → API Keys → Create key.

Keys look like lg_sk_.... Treat them like passwords — anything holding the key can send events to your workspace.

Copy the key when it is created. Logga stores only a SHA-256 hash of it, so that first response is the only place the full key ever appears. Afterwards both the app and the dashboard show just the lg_sk_ prefix. Lost a key? Revoke it and create another — revoking is a soft delete, so the key stops working immediately while its creation and last-used dates stay on record.

3. Send your first event

Events are grouped into channels (created automatically on first use). The only required fields are channel and event.

curl -X POST "https://api.logga.sh/v1/events" \
  -H "Authorization: Bearer lg_sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "general",
    "event": "app_opened",
    "level": "info",
    "metadata": { "screen": "home" }
  }'

Or in JavaScript:

await fetch("https://api.logga.sh/v1/events", {
  method: "POST",
  headers: {
    "Authorization": "Bearer lg_sk_your_api_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    channel: "general",
    event: "app_opened",
    level: "info",
    metadata: { screen: "home" },
  }),
});

A successful ingest returns 201 with the created event. "notified": false is expected — see step 5.

4. See it land

Open the Activity tab (iOS) or Events (dashboard). Your event appears within a second or two. Filter by channel, level, or time range to find it.

Event fields

To route an event to a specific project, append ?projectId=<uuid> to the URL. Otherwise it lands in the environment's default project. Full details in the API Reference and Event Payload Examples.

5. Turn on notifications (optional)

Notifications are off by default — a new channel never pushes until you opt in. This keeps a fresh project from becoming a firehose.

To enable push for a channel: iOS → open the channel → Notifications, or the dashboard channel settings. You can further narrow which events notify with a per-channel rule (e.g. only level = error). See Rules, Reports, and Notifications.

Next steps

• Add Logga With Your AI Agent: one prompt that instruments your codebase for you.
• Instrumentation Recipes: the same client written by hand, per stack.
• API Reference — every endpoint, auth modes, rate limits.
• Event Payload Examples — sessions, actors, idempotency, tags.
• Rules, Reports, and Notifications — alerting when it matters.