Klaviyo

Klaviyo · Live

Ask Klaviyo where revenue actually came from.

Read Klaviyo campaigns, flows, segments, and deliverability so the agent can reconcile revenue and engagement from the source.

Auth
OAuth
Access
Read-only by default
Plan
Every plan
Freshness
Live — every call hits Klaviyo's API
Available on
Every plan

Examples

Questions teams actually ask.

The tools it pulls from are shown inline — every answer in Lumen cites the underlying records it read.

Lifecycle

Top 5 flows by attributed revenue last 30 days, and how that compares to the prior period.

pullslistFlowsgetFlowMetrics
Growth

Which segments grew or shrank the most this week, and what triggered the change?

pullslistSegmentsgetSegmentProfiles
Deliverability

Open and click rates by domain (Gmail, Yahoo, Outlook) on the last welcome-series campaign.

pullsgetCampaigngetCampaignRecipients

Scope

What Lumen sees. What it can change.

Read is on by default. Every write is a separate toggle, capped per user, and logged.

Read

What Lumen reads

Lumen calls Klaviyo's REST API with the OAuth scope you grant at install. Read access only by default — write requires explicit admin opt-in per workspace.

  • Campaigns

    Campaign list, send time, audience, send/open/click/conversion stats

  • Flows

    Flow definitions, step-level metrics, attributed revenue

  • Segments & lists

    Definitions, current size, profile membership, growth deltas

  • Profiles

    Lookup by email or external ID, last events, suppression status

  • Metrics & events

    Placed-order, viewed-product, started-checkout aggregates over time

Write · opt-in

What Lumen can write

Lumen does not write to Klaviyo by default. Profile updates and list adds can be admin-enabled per workspace if you need them.

    Every call is logged with user, operation, resource ID, and date range. Exportable as CSV.

    Install

    Connect in under a minute.

    No keys, no call, no app marketplace fine print.

    1. Authorize
      01

      Connect with OAuth

      In Settings → Integrations → Klaviyo, click Connect. Sign in to Klaviyo and approve the read scopes Lumen requests. The token is stored encrypted.

    2. Confirm scope
      02

      Pick the account

      If your Klaviyo login covers multiple accounts, pick which one the agent should query. You can connect more than one — the agent will scope queries to the account you reference.

    3. Ask
      03

      Try a warm-up question

      Start with "Top 5 campaigns by revenue last 30 days" — the agent will pull the list, sort, and show you the underlying numbers.

    Connect Klaviyo. Ask the hard revenue question.

    OAuth. Read-only by default. Write opt-in.