> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adriel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to connect

> How to connect the Klaviyo data source to Adriel: create a private API key in Klaviyo and paste it into the connection form.

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

<Steps>
  <Step title="Select Klaviyo">
    On the **Data Sources** page, search for **Klaviyo** and select it.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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](/data-sources/g-n/klaviyo/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Reads stopped working after the key changed in Klaviyo">
    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.
  </Accordion>

  <Accordion title="Data is missing beyond a year back">
    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.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Klaviyo data reference" href="/data-sources/g-n/klaviyo/data-reference">
    Metrics, breakdowns, date-range limits, and refresh behavior for the Klaviyo data source.
  </Card>

  <Card title="Klaviyo FAQs" href="/data-sources/g-n/klaviyo/faqs">
    Common questions and expected behaviors for the Klaviyo data source.
  </Card>

  <Card title="How to connect Klaviyo Reporting" href="/data-sources/g-n/klaviyo-reporting/how-to-connect">
    Connect the send-date-aligned form, flow, and campaign reporting source.
  </Card>

  <Card title="Klaviyo Reporting data reference" href="/data-sources/g-n/klaviyo-reporting/data-reference">
    Send-date-aligned reporting that matches Klaviyo's in-app UI.
  </Card>
</CardGroup>