@this-npm-test-org/connection-klaviyo
v0.1.3
Published
Marketing automation: profiles, campaigns, flows, segments, metrics, and email/SMS performance.
Readme
Klaviyo Connection
Connects your agent to Klaviyo for email and SMS marketing data. Pull campaign performance, flow analytics, profile data, segment sizes, and revenue attribution. Read-only access.
Authentication
Private API key.
api_key— Klaviyo private API key from Account > Settings > API Keys
Endpoints
Campaigns
GET /api/campaigns— List campaigns with send date and statusGET /api/campaigns/{id}— Get campaign detail with performance metricsGET /api/campaign-messages/{id}/metrics— Get open rate, click rate, revenue
Flows
GET /api/flows— List automated flows with statusGET /api/flows/{id}— Get flow detail with step-by-step performanceGET /api/flow-messages/{id}/metrics— Get per-message flow performance
Profiles
GET /api/profiles— List profiles with filtersGET /api/profiles/{id}— Get profile detail with event history
Segments
GET /api/segments— List segments with member countsGET /api/segments/{id}/profiles— Get segment members
Metrics
GET /api/metrics— List tracked events/metricsPOST /api/metric-aggregates— Get metric aggregates over time
Rules
- Rate limit: 75 requests/second (Klaviyo v3 API)
- The agent calculates revenue-per-recipient and compares against benchmarks
- Campaign data includes A/B test variant performance when available
- The agent correlates Klaviyo revenue with Shopify orders when both connections exist
