> ## Documentation Index
> Fetch the complete documentation index at: https://help.get-ryze.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Klaviyo

> Connect your Klaviyo account with a private API key so Ryze can read and manage your email and SMS marketing.

Klaviyo connects with a **private API key** — a key you generate in Klaviyo that lets Ryze work with your campaigns, flows, lists, and reporting without sharing your login. Pick the access level that matches what you want Ryze to do: **Full Access** if you want the agent to create and manage things (campaigns, lists, flows), or **Read-Only** if you only want reporting.

<Frame>
  <img src="https://mintcdn.com/ryzeai-5f9aafd5/J1zlXUIV2UUgYxO6/images/klaviyo-connect.png?fit=max&auto=format&n=J1zlXUIV2UUgYxO6&q=85&s=034ba26e14a37de381b7349285b1ab44" alt="The Connect Klaviyo dialog in Ryze with the Private API key field" width="3110" height="1613" data-path="images/klaviyo-connect.png" />
</Frame>

## Step 1 — Generate a private API key

<Steps>
  <Step title="Open settings">
    In Klaviyo, click your **account name** in the lower-left corner, then click **Settings**.

    <Frame>
      <img src="https://mintcdn.com/ryzeai-5f9aafd5/J1zlXUIV2UUgYxO6/images/klaviyo-settings-menu.png?fit=max&auto=format&n=J1zlXUIV2UUgYxO6&q=85&s=4dfdd4b856ed4a53ce2e3f4c9fcf33ef" alt="Opening Settings from the Klaviyo account menu" width="3068" height="1694" data-path="images/klaviyo-settings-menu.png" />
    </Frame>
  </Step>

  <Step title="Create a private key">
    Go to the **API keys** tab and click **Create Private API Key**. Give it a name like `Ryze` so you can recognize it later.

    <Frame>
      <img src="https://mintcdn.com/ryzeai-5f9aafd5/J1zlXUIV2UUgYxO6/images/klaviyo-settings.png?fit=max&auto=format&n=J1zlXUIV2UUgYxO6&q=85&s=5ff4ec73dcbd7a29921f003593caa93c" alt="The Create Private API Key button on the API keys page" width="3068" height="1694" data-path="images/klaviyo-settings.png" />
    </Frame>
  </Step>

  <Step title="Choose access level">
    Pick **Full Access** if you want Ryze to create and manage campaigns, lists, and flows. Pick **Read-Only** if you only want reporting. Avoid a custom key unless you know which scopes you're enabling.

    <Frame>
      <img src="https://mintcdn.com/ryzeai-5f9aafd5/J1zlXUIV2UUgYxO6/images/klaviyo-access-level.png?fit=max&auto=format&n=J1zlXUIV2UUgYxO6&q=85&s=2f777d7563bc4b17da938fcd082a3bf5" alt="Selecting the access level for the API key" width="3068" height="1694" data-path="images/klaviyo-access-level.png" />
    </Frame>
  </Step>

  <Step title="Copy the key">
    Click **Create**, then copy the key (it starts with `pk_`). Klaviyo shows it once — copy it now.
  </Step>
</Steps>

<Warning>
  The private API key is shown only once. If you lose it, delete it in Klaviyo and create a new one — keys can't be edited after creation.
</Warning>

## Step 2 — Connect in Ryze

In **Workspace Settings → Integrations**, click **Connect** on the Klaviyo card, then paste your key into the **Private API key** field and click **Continue**. Ryze verifies the key against your Klaviyo account and confirms the account name.

## Troubleshooting

* **Key rejected** — make sure you copied the full `pk_...` key and that it has the `accounts:read` scope. A Read-only or Full key always includes it; a custom key may not.
* **Can't find API keys** — they live under **Settings → API keys** (click your account name in the lower-left to reach Settings).
* **Wrong account connected** — each key belongs to one Klaviyo account. To connect a different account, generate a key while logged into that account.

Still stuck? Email [support@get-ryze.ai](mailto:support@get-ryze.ai).