Connect Klaviyo

Adding Klaviyo gives StoreBrief visibility into your email and SMS performance - flow revenue, campaign results, list health, and email revenue attribution. This data enriches your daily briefs and unlocks email/SMS diagnostics.

Cost: Free (uses your existing Klaviyo account) Time to complete: ~3 minutes

Why connect Klaviyo?

Most analytics tools treat email as an afterthought. StoreBrief reads your Klaviyo data alongside store data, so your daily brief shows the full revenue picture:

Email revenue as % of total revenue
Which flows are driving (or losing) money
Campaign performance trends
List health and deliverability signals
SMS revenue attribution

Step 1: Create a Klaviyo Private API key

Log into Klaviyo
Go to Settings → API Keys
Click Create Private API Key
Name it "StoreBrief"
Set these scopes (read-only):
- campaigns:read
- flows:read
- metrics:read
- lists:read
- segments:read
- events:read
Click Create and copy the key (starts with pk_)

Read-only access. StoreBrief never writes to Klaviyo - it reads performance data only.

Step 2: Add to your environment

Add the key to your .env file:

KLAVIYO_API_KEY=pk_xxxxxxxxxxxxx

Step 3: Tell StoreBrief to connect

In your AI client:

Connect to Klaviyo. My API key is configured.

StoreBrief will verify the connection and report what it finds (number of active flows, list size, etc.).

What StoreBrief gets from Klaviyo

Flow Performance:

Revenue per flow (Welcome, Abandoned Cart, Post-Purchase, Browse Abandon, Winback)
Flow conversion rate (received → placed order)
Revenue per recipient
Open and click rates by flow

Campaign Performance:

Last 30 days of campaign results
Open rate, click rate, revenue, unsubscribes
Campaign revenue as % of total revenue
A/B test results

List Health:

Total list size and 30-day growth rate
Unsubscribe rate trending
Engagement tiers (engaged, semi-engaged, unengaged)
Deliverability signals (bounce rate, spam complaints)

Revenue Attribution:

Email revenue as % of total store revenue
SMS revenue as % of total store revenue
Flow vs. campaign revenue split
Revenue per email sent (RPE) trending

Verify it's working

Ask StoreBrief:

Run a Klaviyo health check

You should get a report covering flow performance, list health, and email revenue attribution.

Note

Klaviyo is an additional data source - it doesn't replace your store data connection (Kleio, Triple Whale, or Shopify Direct). You need at least one store data source connected for daily briefs. Klaviyo enriches those briefs with email/SMS channel data.