Skip to main content
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. Use a Full Access key, or a custom key that includes the Accounts read scope.
The Connect Klaviyo dialog in Ryze with the Private API key field

Step 1 — Generate a private API key

1

Open settings

In Klaviyo, click your account name in the lower-left corner, then click Settings.
Opening Settings from the Klaviyo account menu
2

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.
The Create Private API Key button on the API keys page
3

Choose access level

Pick Full Access — Ryze can then read your reporting and create and manage campaigns, lists, and flows. If you build a custom key instead, make sure it includes the Accounts read scope.
Selecting the access level for the API key
4

Copy the key

Click Create, then copy the key (it starts with pk_). Klaviyo shows it once — copy it now.
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.

Step 2 — Connect in Ryze

On the Integrations page, 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. The card shows Connected — click View to see the account name.

What the agent can do

  • Read — campaigns, flows, lists, segments, sign-up forms, metrics, and performance reports (opens, clicks, conversions, revenue)
  • Change — create and manage campaigns, lists, flows and sign-up forms when you ask (needs a Full Access key)
  • Delete — delete lists and other objects when you explicitly ask (needs a Full Access key)
By default the agent runs its tools on its own: the Tool approvals setting in the chat composer starts on Skip all approvals. To review changes before they happen, switch it to Approve write & delete (reads run freely, changes need approval) or Manual approve (every tool that touches your data needs approval). Scheduled tasks run without an approval step.
Klaviyo serves performance reports through requests that Ryze counts as changes. With Approve write & delete on, you’re also asked to approve report requests.

Troubleshooting

  • Key rejected — make sure you copied the full pk_... key and that it has the accounts:read scope. A Full Access 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.