Klaviyo connection setup

This guide walks you through creating a private API key in Klaviyo and connecting your account to LinkyFlow, so you can work with its results, profiles, lists, segments, campaigns and flows in Excel or in the web app.

Requirements

• A Klaviyo account
• The right to create API keys in it

Step 1 — Create a private API key

1. In Klaviyo, open your account menu (bottom left) and choose Settings, then API keys.
2. Click Create Private API Key and name it LinkyFlow.
3. Choose Read-only key to let LinkyFlow read, or Full access key to let it write too. Without full access, everything is read and nothing is written.
4. Create the key and copy it (pk_…): Klaviyo shows it once.

Step 2 — Add the connection in LinkyFlow

1. In Excel or the web app, open Connections → Add connection.
2. Choose Klaviyo from the provider list.
3. Paste the key in Private API Key.
4. Save.

One connection reads one Klaviyo account: to connect another account, add another connection with its own key. Connect with Klaviyo, signing in without a key, comes when LinkyFlow's Klaviyo app is published; until then, the key is the way to connect.

Step 3 — Load your first query

1. Insert a LinkyFlow query and pick the Klaviyo provider.
2. Choose Account, select your connection in the Link field, and run it: the account's organisation, sender defaults, timezone and currency load.
3. Choose Profiles and run it. Move on to the next page, or pick All results to read the pages in a row.
4. Choose Metrics and note the ID of the metric your conversions are counted on — Placed Order, say: Campaign Values Reports and Flow Values Reports ask for it as their Conversion Metric.

Ending LinkyFlow's access

Delete the connection in LinkyFlow, and remove the key in Klaviyo under Settings → API keys: once the key is gone, nothing can use it.

LinkyFlow keeps the key server-side: it is never shown again, and never sent to an AI assistant.