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

# Klaviyo

> Connect Klaviyo to Adapt to analyze lists, campaigns, flows, and metrics

Klaviyo is a marketing automation platform for email and SMS. Connect it to
Adapt with a Klaviyo private API key.

## Set up credentials

<Steps>
  <Step title="Open API Keys settings">
    Sign in to Klaviyo, click your organization name in the lower left, go to
    **Settings**, then open the **API Keys** tab.

    <Note>
      You must have an Owner, Admin, or Manager role to create API keys.
    </Note>
  </Step>

  <Step title="Create a private API key">
    Under **Private API Keys**, click **Create Private API Key** and give the
    key a name.
  </Step>

  <Step title="Choose a scope">
    Select a scope type: **Read-Only**, **Full Access**, or **Custom**. For
    analysis, read access to the resources you need is enough. Scopes cannot be
    changed after creation.
  </Step>

  <Step title="Copy the key">
    Click **Create** and copy the key (it starts with `pk_`).

    <Note>
      The key is shown only once and cannot be viewed again. Store it securely.
    </Note>
  </Step>
</Steps>

## Connect to Adapt

<Steps>
  <Step title="Open Integrations">
    In Adapt, go to **Settings > Integrations**.
  </Step>

  <Step title="Find Klaviyo">
    Search for **Klaviyo** and select it from the catalog.
  </Step>

  <Step title="Start the connection">
    Click **Connect** to open the connection form.
  </Step>

  <Step title="Add your credentials">
    Enter the values you gathered above, then click **Add connection**:

    | Secret Name       | Value                        |
    | ----------------- | ---------------------------- |
    | `KLAVIYO_API_KEY` | Your Klaviyo private API key |

    You can rename the connection and choose whether it is shared with your
    organization or kept personal to you.
  </Step>

  <Step title="Test the connection">
    Ask Adapt to list your segments.
  </Step>
</Steps>

### Security

* Credentials are encrypted at rest with AES-256
* Scope the private key to the minimum access you need, such as read-only
* Use a different private API key for each application, and rotate keys periodically
* Never share your private API key or commit it to source control

## Capabilities

Analyze lists and segments, campaigns, flows, and metrics in Klaviyo from Adapt.

### Examples

Review lists and segments:

```
List my Klaviyo segments and how many profiles are in each.
```

Check campaign performance:

```
Show open and click rates for my last 5 Klaviyo email campaigns.
```

Inspect a flow:

```
Summarize the performance of my Klaviyo welcome flow this month.
```

Pull a metric:

```
What was my total Klaviyo "Placed Order" metric value last week?
```
