Skip to main content
Klaviyo is a marketing-automation platform for e-commerce email and SMS. Connecting the base Klaviyo data source brings any event metric the account tracks — such as opens, clicks, placed orders, and started checkouts — into Adriel dashboards, aggregated by event time and broken down by event property alongside paid-media sources. Adriel offers a separate Klaviyo Reporting data source for send-date-aligned form, flow, and campaign reporting that matches Klaviyo’s in-app reports. Connect that source instead when the goal is to reproduce Klaviyo’s UI figures rather than run flexible cross-metric analysis.

​
Before you connect

The following are required:
  • A Klaviyo account with access to create API keys.
  • A private API key generated in Klaviyo. Create one under Klaviyo Settings → API keys → Create Private API Key, then copy the key before leaving the page. Klaviyo authenticates every request with this key, so it must remain valid in Klaviyo for data to keep flowing.

​
Connect Klaviyo

1

Select Klaviyo

On the Data Sources page, search for Klaviyo and select it.
2

Enter the private API key

In the connection form, paste the private API key into the API Private Key field. This is the only credential required — the base Klaviyo connector uses key-based authentication, with no separate sign-in or OAuth step.
3

Submit

Click Submit to complete the connection. Catalogs of lists, segments, flows, campaigns, and forms are fetched on demand when a dashboard loads, so entities become available without waiting for a scheduled sync.

​
What gets imported

The connector queries Klaviyo’s metric-aggregates endpoint live and can report any event metric in the account — engagement, revenue, and conversion events — each available in count, unique, and value aggregations, broken down by event property. Because it aggregates by the time each event occurred, totals can differ from Klaviyo’s in-app campaign reports, which use send date. For the full list of metrics, breakdowns, date-range limits, and refresh behavior, see the Klaviyo data reference.

​
Troubleshooting

The connector authenticates with a private API key and has no token-refresh flow. If the key is revoked or regenerated in Klaviyo, subsequent reads fail until the connection is updated with a new key. Generate a fresh private API key in Klaviyo and reconnect the data source with it.
A single query fetches at most one year of data; wider date ranges are truncated to the most recent year. To review a longer span, split the analysis into separate windows of a year or less.

Klaviyo data reference

Metrics, breakdowns, date-range limits, and refresh behavior for the Klaviyo data source.

Klaviyo FAQs

Common questions and expected behaviors for the Klaviyo data source.

How to connect Klaviyo Reporting

Connect the send-date-aligned form, flow, and campaign reporting source.

Klaviyo Reporting data reference

Send-date-aligned reporting that matches Klaviyo’s in-app UI.