Reviewer checklist
- 1Install Leakio from Klaviyo or open Workspace Settings → Integrations and connect from there.
- 2Approve the OAuth prompt with the requested read-only scopes.
- 3Confirm the redirect returns to Leakio and the Klaviyo connection appears active.
- 4Run a brand sync or open Leo / Brand QA to confirm read-only Klaviyo access is working.
Installation flow to test
- Start the install from the Klaviyo marketplace or from Leakio workspace settings.
- Authenticate the Klaviyo account that owns the workspace you want to test.
- Approve the OAuth scopes: campaigns:read, flows:read, and metrics:read.
- Verify the install lands back on /workspace/settings?tab=integrations with an active connection card.
API endpoints and scopes
Account identification
GET /api/accounts
Used during OAuth exchange to identify the connected Klaviyo account and label the integration.
Campaign metadata and reporting
GET /api/campaigns?include=campaign-messages&filter=equals(messages.channel,'email'|'sms')
Loads campaign lists, campaign-message labels, and campaign-level report data.
Campaign analytics
POST /api/campaign-values-reports/
Fetches campaign performance statistics for the dashboard and QA views.
Flow metadata and reporting
GET /api/flows?page[size]=50 and POST /api/flow-values-reports
Loads flow status, names, and flow-level performance metrics.
Metric lookup and aggregates
GET /api/metrics?fields[metric]=name, GET /api/custom-metrics, POST /api/metric-aggregates
Used to resolve delivery, conversion, and other metric totals for reporting.
Audience and form metadata
GET /api/lists, GET /api/segments, GET /api/forms
Used for richer labels and summaries; the app falls back gracefully if the account does not expose some metadata.
Audience and form detail lookups
GET /api/lists/{id}?additional-fields[list]=profile_count and GET /api/segments/{id}?additional-fields[segment]=profile_count
Used to enrich list and segment detail cards with profile counts where available.
Functional checks
- The active connection card shows the correct Klaviyo account name after install.
- Brand profile sync and campaign plan sync can run from the connected workspace.
- Leo / Brand QA can query connected Klaviyo data in read-only mode.
- The user can disconnect and reconnect without losing the workspace-brand mapping.