Klaviyo
Connect Klaviyo to Reeve for email campaign analytics, flows, segments, and SMS data.
Klaviyo Connector
Connect Klaviyo to pull email and SMS campaign performance, flow analytics, segment data, and revenue attribution into Reeve.
What You Get
| Data | Examples |
|---|---|
| Email campaigns | Send count, open rate, click rate, unsubscribes |
| Flows | Automated flow status, performance metrics |
| Segments | Audience segments with member counts |
| SMS campaigns | SMS sends, clicks, opt-outs |
| Revenue attribution | Revenue generated from email/SMS |
| Templates | Email template library |
Setup
Get your Klaviyo Private API Key
- Log in to Klaviyo
- Click your organization name in the bottom-left corner
- Go to Settings → API Keys
- Click Create Private API Key
- Name it (e.g., "Reeve Integration")
- Set permissions to Read-only — this is sufficient for analytics
- Copy the key — it starts with
pk_
Connect in Reeve
In the Cockpit, go to Connectors and find Klaviyo under Marketing. Click Connect.
A modal opens with one field:
| Field | Value | Example |
|---|---|---|
| Private API Key | Your Klaviyo private key | pk_abc123def456... |
Paste your key and click Connect.
Validated and saved
Reeve validates the key against the Klaviyo API. If valid, the key is encrypted and stored. Klaviyo shows as Connected.
Read-only access is all Reeve needs for analytics. You can create a key with write permissions if you want agents to create campaigns or manage flows.
Using Klaviyo Data
In the Dashboard
The Klaviyo connector adds an Email Marketing panel to the Dashboard:
- Open rates and click rates over time
- Campaign performance comparison
- Revenue attributed to email/SMS
- Flow performance overview
Via Agent Tools
Your agents use the reeve_email tool to interact with Klaviyo:
// Service status and connection health
reeve_email({ action: "get_status" })
// Analytics overview
reeve_email({ action: "get_analytics" })
// List recent campaigns
reeve_email({ action: "list_campaigns" })
// Get a specific campaign
reeve_email({ action: "get_campaign", campaign_id: "abc123" })
// List automated flows
reeve_email({ action: "list_flows" })
// List audience segments
reeve_email({ action: "list_segments" })
// List email templates
reeve_email({ action: "list_templates" })
// List SMS campaigns
reeve_email({ action: "list_sms_campaigns" })Campaign Management
With write permissions on your API key, agents can also create and manage campaigns:
// Create a new email campaign
reeve_email({
action: "create_campaign",
campaign_data: {
name: "Spring Sale 2026",
subject: "Spring is here — 20% off everything",
segment_id: "segment_123"
}
})
// Schedule a campaign
reeve_email({
action: "schedule_campaign",
campaign_id: "campaign_abc",
schedule_data: { send_at: "2026-03-15T10:00:00Z" }
})Example Conversations
- "What's our email open rate this month?"
- "Which campaign had the highest click-through rate?"
- "Show me our active automated flows."
- "How much revenue did email generate last quarter?"
- "Draft a campaign for our new product launch."
Troubleshooting
| Issue | Solution |
|---|---|
| Invalid API key | Ensure you're using a Private API key (starts with pk_), not a Public key |
| Permission denied | Check that the key has at least Read-only access for the data types you need |
| No data showing | New connections take a moment for the first data pull — refresh after 30 seconds |
Disconnecting
- Go to Connectors → hover over Klaviyo → click Disconnect
- The API key is deleted from Reeve's encrypted store
For safety, you should also revoke the API key in Klaviyo under Settings → API Keys.