List
Read live records straight from the Klaviyo API.
- Source
- Marketing Analytics
- Generally available
- 7 entities
Move Klaviyo data anywhere it matters.
Stream Klaviyo campaigns and campaigns detailed to any warehouse or AI app.
Source
Klaviyo
Snowflake
BigQuery
Postgres
Databricks
Claude
- Streams
- 14
- Entities
- 7
- Actions
- 4
- Destinations
- 50+
- Certified support
- 4.0.2
Overview
What is the Airbyte Klaviyo connector?
The Airbyte Klaviyo connector extracts data from Klaviyo and loads it into 50+ destinations such as Snowflake, BigQuery, Databricks or Postgres, with full refresh and incremental sync. It publishes 14 streams you can select per connection.
- 01
Sync to your warehouse
Land 14 Klaviyo tables in 50+ destinations on a schedule you control.
- 02
Context store search
Query synced Klaviyo data with filters, sorting and semantic search, without spending Klaviyo API rate limits.
- 03
Incremental syncs
Pull only the records that changed since the last run instead of reloading everything.
- 04
One authorization
Authenticate Klaviyo once. The same connection powers scheduled syncs and runtime actions.
14 streams
Every table you can sync from Klaviyo
Campaigns Sync modes FullIncr. Campaigns Detailed Sync modes FullIncr. Campaign Values Reports Sync modes FullIncr. Email Templates Sync modes FullIncr. Events Sync modes FullIncr. Events Detailed Sync modes FullIncr.
Setup
Live in ten steps
First, navigate to the Klaviyo source connector page on Airbyte.com.
Click on the "Add Source" button to begin the process of adding your Klaviyo credentials.
Enter a name for your Klaviyo source connector and click on the "Next" button.
You will be prompted to enter your Klaviyo API key. To obtain your API key, log in to your Klaviyo account and navigate to the "API Keys" section under "Account Settings."
Click on the "Create API Key" button and copy the generated key.
Paste the API key into the Airbyte Klaviyo source connector page and click on the "Test" button to ensure that the connection is successful.
Once the connection is successful, click on the "Next" button to proceed to the next step.
Select the data you want to replicate from Klaviyo and click on the "Next" button.
Choose the destination where you want to replicate your Klaviyo data and click on the "Create Connection" button.
Your Klaviyo source connector is now set up and ready to replicate data to your chosen destination.
Configuration fields
| Field | Type | Description |
|---|---|---|
| api_key* | string | Klaviyo API Key. See our docs if you need help finding this key. |
| disable_fetching_predictive_analytics | boolean | Certain streams like the profiles stream can retrieve predictive analytics data from Klaviyo's API. However, at high volume, this can lead to service availability issues on the API which can be improved by not fetching this field. WARNING: Enabling this setting will stop the "predictive_analytics" column from being populated in your downstream destination. |
| event_metric_ids | string | OPTIONAL: Comma-separated list of Klaviyo metric IDs to filter the events and events_detailed streams. If left empty, events for ALL metrics will be synced. Specify only the metrics you need to significantly reduce sync volume and duration. Note: Klaviyo does not support filtering by custom metrics - only built-in metrics can be filtered. Find metric IDs in your Klaviyo account under Analytics > Metrics, or use the metrics stream to list all available metrics and their IDs. |
| lookback_window | integer | The number of days to look back when syncing data in incremental mode. This helps capture any late-arriving data. Only applies to the events_detailed stream. For the flow_series_reports stream, use Reporting Lookback Window instead. |
| metric_ids | string | OPTIONAL: Comma-separated list of specific metric IDs to use for flow_series_reports and campaign_values_reports streams. If left empty, the connector will automatically fetch reports for ALL available metrics in your account. Due to Klaviyo's strict API rate limits - see Klaviyo's API docs, syncing all metrics can be extremely slow and may take hours to complete. RECOMMENDED: Specify only the conversion metrics you need (e.g., "RESQ6t" for Placed Order) to avoid slow syncs. Find metric IDs in your Klaviyo account under Analytics > Metrics, or use the metrics stream to list all available metrics and their IDs. |
| num_workers | integer | The number of worker threads to use for the sync. The performance upper boundary is based on the limit of your Klaviyo plan. More info about the rate limit plan tiers can be found on Klaviyo's API docs. |
| reporting_lookback_window | integer | Re-syncs the last N days of the flow_series_reports stream on every incremental run. Klaviyo keeps updating conversion attribution after a send - by default for up to 5 days, and up to 90 days if you raise the attribution window in your account settings - so the numbers first reported for a day keep changing for a while. Set this to at least your attribution window to pick those revisions up. Because flow_series_reports rows are keyed by the calendar day they report on, a destination that deduplicates on the primary key replaces the row previously written for a re-synced day, while in append mode each re-synced day adds an extra row per sync. This does not apply to campaign_values_reports: that endpoint returns a single aggregate for the whole requested period instead of a per-day breakdown, so a re-read cannot replace anything and would only add double-counted rows. Defaults to 0 (no re-sync). |
| start_date | string | UTC date and time in the format 2017-01-25T00:00:00Z. Any data before this date will not be replicated. This field is optional - if not provided, Airbyte will replicate the data for the last year. The metrics stream is not affected by this field and always syncs all metric definitions. |
4 actions
Supported Klaviyo actions
Get
Fetcha single record by ID.Context Store Search
Query synced data with filters and sorting, with no API rate limits.
Semantic Search
Natural-language search across synced Klaviyo records.
Full parameter-level details live in the Klaviyo entity reference.
Hybrid deployment
Sovereign by architecture, not by policy.
The data plane runs in your environment. Records, credentials and keys stay with you; the control plane only receives configuration and job metadata.
- Cloud
- OSS
- Hybrid
Your environment
Airbyte control plane
Use cases
What teams build with Klaviyo
List all profiles in my Klaviyo account
Show me details for a recent profile
Show me all email lists
Show me details for a recent email list
What campaigns have been created?
Show me details for a recent campaign
Show me all email campaigns
List all events for tracking customer actions
Show me all metrics (event types)
Show me details for a recent metric
What automated flows are configured?
Show me details for a recent flow
List all email templates
Show me details for a recent email template
Show me the most recent tracked event in my account
Related connectors
FAQ
Klaviyo connector questions
Do I need more than one Klaviyo connection?
No. One Klaviyo authorization powers both the scheduled syncs that land data in your destination and the entity actions your agents call at runtime.
Do Klaviyo entity actions need a sync to run first?
No. Entity actions read and write through the Klaviyo API as they are called, so they work immediately. Context store search is the exception: it queries data Airbyte has already synced, which is what lets it filter and sort without spending API rate limits.
What data can I sync from Klaviyo with Airbyte?
14 streams, including Campaigns, Campaigns Detailed, Campaign Values Reports, Email Templates, Events, Events Detailed, Flows, Flow Series Reports and more.
Does the Klaviyo connector support incremental sync?
Yes. The Klaviyo connector supports incremental sync on selected streams, and full refresh on every stream.
Where can I run the Klaviyo connector?
Run the Klaviyo connector on Cloud, OSS, Hybrid. Hybrid deployments keep the data plane in your environment while the control plane orchestrates syncs.
Didn't find your answer? Talk to sales
Start syncing Klaviyo in minutes.
Free 14-day trial. One connection powers your scheduled syncs and your live Klaviyo actions.