> ## Documentation Index
> Fetch the complete documentation index at: https://docs.northbeam.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Klaviyo Setup
> Connect Klaviyo with API keys and add Northbeam UTMs so sign-ups and revenue tie back to your campaigns and flows.
When you're done, Northbeam shows the visits, revenue, and orders from your Klaviyo campaigns and flows, plus email and SMS sign-ups from Klaviyo's forms.
**Before you start**, make sure you have:
* A Klaviyo login that can view and create API keys (**Settings → API Keys**)
* Access to edit your Klaviyo campaigns and flows
Paste your Klaviyo API keys into Northbeam.
Add `nb_klid` and UTMs to your campaigns and flows.
See which channels drive your sign-ups.
Check that parameters and data are arriving.
The connection imports all Klaviyo events tagged "new subscriber". They show up under the **Email Sign Ups** metric, along with **Cost per Email Sign Up** and **Email Sign Up Rate**.
**A. Find your Public API Key**
1. Log in to Klaviyo.
2. Go to **Settings → API Keys**.
3. Copy the **Public API Key**.
**B. Create a Private API Key**
1. In Klaviyo, go to **Settings → API Keys**.
2. Under **Private API Keys**, click **Create Private API Key**.
3. Name the key something like **Northbeam (Read-only)**.
4. Set permissions to **Read-only**.
5. Click **Create**.
**C. Enter the keys in Northbeam**
Open [Connections](https://dashboard.northbeam.io/settings/connections), select **Klaviyo**, and paste your **Public API Key** and **Private API Key**.
Klaviyo's own help pages: [Finding your Public API Key](https://help.klaviyo.com/hc/en-us/articles/115005062267) and [Creating a Private API Key](https://help.klaviyo.com/hc/en-us/articles/7423954176283).
**If you skip this step:** sign-up volume is missing, and Email Sign Ups, Cost per Email Sign Up, and Email Sign Up Rate stay empty.
Set these as account-wide UTMs in Klaviyo. Northbeam looks for `utm_source`, `utm_medium`, `utm_campaign`, and `nb_klid`.
| UTM key | Campaign value | Flow value |
| :- | :- | :- |
| `utm_source` | Klaviyo\* | Klaviyo\* |
| `utm_medium` | email\* | email\* |
| `utm_campaign` | Campaign Name\* | Flow Message Name\* |
| `nb_klid` | Klaviyo profile ID | Klaviyo profile ID |
\*These are *recommended* values. You can use your own, but they affect how Klaviyo shows up in your dashboard. The walkthrough video below explains how.
The only required value is `nb_klid` = the Klaviyo profile ID, for both campaigns and flows.
For more detail on the Sales page, also add:
* `utm_term`: shows at the **Ad set** level
* `utm_content`: shows at the **Ad** level
**If you skip this step:** revenue isn't attributed to your Klaviyo campaigns or flows.
The connection pulls in raw sign-up events. To see which channels drove them (for example, "Facebook Ads drove X email sign-ups"), place the Northbeam [Sign Up Event - Email](/docs/setting-up-klaviyo-for-northbeam) on your site.
**If you skip this step:** sign-ups show as Unattributed.
For a full check:
* **Parameters captured:** follow [Checking UTM tracking](/docs/checking-utm-tracking) to confirm the Northbeam parameters reach your landing pages.
* **Connection syncing:** follow [Checking platform connections](/docs/checking-api-connections) to confirm the account shows as connected and data is arriving.
If a check fails, see [Troubleshooting Northbeam data](/docs/troubleshooting-tracking-issues).
## Add Klaviyo spend (optional)
The Klaviyo connection doesn't pull spend or cost data. To get cost-based metrics like ROAS and CAC for Klaviyo, upload your costs with a [Custom Spendsheet](/docs/tracking-for-other-platforms#step-2-upload-costs-via-custom-spend).
Custom spend lands under a platform called **Other**. Use the [Breakdowns Manager](/docs/manage-breakdowns) to move it into **Klaviyo**.
**If you skip this:** no costs are tied to Klaviyo.
## Need help?
Common Klaviyo setup and reporting questions.
Start here if a check above fails.