> ## 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 Reporting data source to Adriel: enter a private API key, choose a Type and timezone, and submit.

Klaviyo Reporting is a distinct Adriel connector from the base Klaviyo integration. It reads Klaviyo's dedicated series-report endpoints for forms, flows, and campaigns — the same endpoints Klaviyo's own reporting UI uses — so the numbers reconcile against the Klaviyo dashboard. Connecting brings send-date report data for one asset Type (Forms, Flows, or Campaigns) into Adriel dashboards.

This is the reporting-API variant. For on-demand, event-time metrics, use the base [Klaviyo connector](/data-sources/g-n/klaviyo/how-to-connect) instead.

## Before you connect

The following are required:

* A Klaviyo account with access to the reporting data being connected.
* A Klaviyo **private API key**. Create one in Klaviyo by following [Klaviyo's guide to creating a private API key](https://help.klaviyo.com/hc/en-us/articles/7423954176283).

## Connect Klaviyo Reporting

<Steps>
  <Step title="Enter the API Key">
    On the **Data Sources** page, search for **Klaviyo Reporting** and select it. Enter the Klaviyo **private API key** in the **API Key** field. To create a key, see [Klaviyo's guide to creating a private API key](https://help.klaviyo.com/hc/en-us/articles/7423954176283).
  </Step>

  <Step title="Configure the data source">
    Complete the three required fields:

    * **Name** — the data source name shown in Adriel.
    * **Type** — select **Forms**, **Flows**, or **Campaigns** from the dropdown. Each Type reads a different Klaviyo endpoint and exposes its own statistics, and the Type cannot be changed after the data source is created. Complete the Type-specific configuration that appears for the selected Type — for example, Flows and Campaigns require a **Conversion Metric**. If this configuration is left incomplete, **undefined** appears next to the selected Type in the data source name.
    * **Timezone** — select the reporting timezone from the dropdown.
  </Step>

  <Step title="Submit">
    Click **Submit** to complete the connection. The initial sync retrieves the last 60 days of report data in the background.
  </Step>
</Steps>

## What gets imported

The connector imports report data for the single Type selected at connection time: form statistics for Forms, or the shared messaging statistics (delivery, engagement, audience health, and — with a Conversion Metric — conversions) for Flows and Campaigns. Data is attributed to the send date and refreshed on a daily cache.

For the complete list of metrics, breakdowns, refresh cadence, and limits, see the [Klaviyo Reporting data reference](/data-sources/g-n/klaviyo-reporting/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="'undefined' appears in the data source name">
    The Type-specific configuration for the selected Type was left incomplete at creation. Complete the configuration for the chosen Type — for Flows and Campaigns this includes selecting a **Conversion Metric**. Because the Type is fixed at creation, create a new data source with the configuration completed if the value cannot be corrected on the existing one.
  </Accordion>

  <Accordion title="Numbers differ from the base Klaviyo connector">
    Klaviyo Reporting attributes data to the campaign or flow send date, matching Klaviyo's reporting UI. The base Klaviyo connector attributes to the event date, so the two connectors can report different totals for the same range.
  </Accordion>

  <Accordion title="The wrong asset Type was selected">
    The Type (Forms, Flows, or Campaigns) is chosen at creation and cannot be changed. To report on a different Type, create a separate Klaviyo Reporting data source with that Type selected.
  </Accordion>

  <Accordion title="Data older than 60 days is missing">
    The initial back-fill retrieves the last 60 days from the connection date. Data older than that window cannot be retrieved.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Klaviyo Reporting data reference" href="/data-sources/g-n/klaviyo-reporting/data-reference">
    Metrics, breakdowns, refresh cadence, and limits for Klaviyo Reporting.
  </Card>

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

  <Card title="How to connect Klaviyo" href="/data-sources/g-n/klaviyo/how-to-connect">
    Connect the base Klaviyo connector for on-demand, event-time metrics.
  </Card>

  <Card title="How to connect Mailchimp" href="/data-sources/g-n/mailchimp/how-to-connect">
    Connect an alternative email marketing platform.
  </Card>
</CardGroup>