Klaviyo — Source
Source — Vendo imports campaign engagement, profile, and flow data from Klaviyo for analytics.
Klaviyo is also available as a destination.
What Vendo Imports
Vendo extracts the following streams from the Klaviyo API:
| Stream | Description |
|---|---|
| Events | Email/SMS activity — opens, clicks, bounces, purchases, custom events |
| Profiles | Contact profiles with properties, consent status, and segmentation data |
| Campaigns | Campaign metadata including send dates, audiences, and performance |
| Lists | List definitions and membership counts |
| Flows | Automation flow definitions and trigger configurations |
| Metrics | Metric definitions for event types tracked in Klaviyo |
Events Stream
Klaviyo events are imported with their full attribute set, including:
- Event type and metric name
- Associated profile (email, ID)
- Event properties and metadata
- Timestamps and flow/campaign attribution
Profiles Stream
All Klaviyo profiles are imported with:
- Contact information (email, phone, name)
- Custom properties
- Consent and subscription status
- List and segment memberships
Campaigns Stream
Campaign metadata including:
- Campaign name, status, and type (email/SMS)
- Send time and audience info
- Message content references
Lists Stream
List definitions with:
- List name and ID
- Member count
- Creation and update timestamps
Flows Stream
Automation flow data including:
- Flow name, status, and trigger type
- Action sequences and filter definitions
Metrics Stream
Metric definitions for all event types tracked in your Klaviyo account.
Authentication
Klaviyo uses a single Private API Key for both source and destination operations.
- Key format: starts with
pk_ - Auth header:
Authorization: Klaviyo-API-Key pk_... - API revision:
2024-10-15
Setup
- In the Vendo app, navigate to Apps and click Add App
- Select Klaviyo from the integration catalog
- Enter your Private API Key (starts with
pk_)- Found in Klaviyo under Settings > API Keys
- Vendo validates the key against the Klaviyo API
- Once connected, configure which source streams to enable
Platform Details
| Setting | Value |
|---|---|
| Sync Method | Server-side via Klaviyo REST API (JSON:API) |
| Rate Limit | 75 requests/second with automatic backoff |
Verify Setup
- After connecting, check the app status shows Active
- Verify data appears in your Vendo BigQuery dataset
- Check Vendo job logs for sync activity and any errors
Last updated on