Back to Docs

Lite SDK & Capture API

Generic page/track telemetry was removed in 2026-06. Send events via POST /v1/capture or use lite npm helpers for service journeys and handshake tokens.

POST /v1/capture

Authenticate with header X-Write-Key and send a JSON batch:

fetch("https://analytics.example.com/v1/capture", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-Write-Key": "YOUR_WRITE_KEY",
  },
  body: JSON.stringify({
    batch: [{
      event_id: crypto.randomUUID(),
      event_name: "page_view",
      event_type: "page",
      timestamp: new Date().toISOString(),
      anonymous_id: crypto.randomUUID(),
      session_id: crypto.randomUUID(),
      context: { page: { url: location.href, title: document.title } },
      properties: { pageId: "optional-uuid-for-web-builder-billing" }
    }],
    sent_at: new Date().toISOString()
  })
});

@analytics/sdk (lite)

import {
  completeServiceJourney,
  extractHandshakeTokenFromUrl,
} from "@analytics/sdk";

// journey_id must be in window.location.search (?journey_id=...)
completeServiceJourney({
  endpointBase: "https://dashboard.example.com/api/dashboard",
});

See Quick Start and the integration guide in docs/10-operational/guides/integration.md.

Deprecated: sdk.js

The legacy sdk.js embed and analytics.page() / analytics.track() snippet are no longer supported. Existing embeds receive a no-op stub with HTTP 410.