> For the complete documentation index, see [llms.txt](https://docs.roadmap.so/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roadmap.so/reviews/integrations/klaviyo-review-integration/how-to-integrate-roadmap-with-klaviyo.md).

# How to integrate Roadmap with Klaviyo

Use the embedded walkthrough below, then follow the written steps for a fast copy/paste setup.

![Select the Klaviyo tab to access all Klaviyo integration options and settings.](https://content.gitbook.com/content/J8asLD4FVCFagK40xEr4/blobs/hyP7fSuPDm6LCosT84CZ/6aa5a26e%204806%20464a%2087e5%2008b089e212c1.png)

### Klaviyo Integration Set Up

Discover how to generate and add a Klaviyo API key to activate seamless store-email integration.

### Before you start

* You need access to your **Shopify admin** and the **Roadmap** app.
* You need access to your **Klaviyo** account to create a **Private API key**.

Your Klaviyo Private API key is like a password. Copy it once and store it in a secure place (for example, a password manager).

***

{% stepper %}
{% step %}

#### Step 1: Open Roadmap Settings in Shopify

Go to Roadmap in Shopify

In Shopify, open **Apps** and select **Roadmap**. In the Roadmap left menu, click **Settings**.

![Shopify admin showing the Roadmap app with the Settings item highlighted](https://content.gitbook.com/content/J8asLD4FVCFagK40xEr4/blobs/6X1yEbBPqxpsFIMsgADD/frame_001.jpg)
{% endstep %}

{% step %}

#### Step 2: Create a Klaviyo Private API key

Open Klaviyo’s Create Private API Key screen

In Klaviyo, go to the page titled **Create Private API Key**, then enter a name in **Private API Key Name** so you can recognize it later (for example, `Roadmap`).

![Klaviyo Create Private API Key screen with the Private API Key Name field](https://content.gitbook.com/content/J8asLD4FVCFagK40xEr4/blobs/peVw3FGjFmlVULJVe3a8/frame_002.jpg)

Generate and copy the key

Click **Create**. When Klaviyo shows **Your Private Key**, click the copy icon and save the key somewhere secure.

![Klaviyo showing the generated private key with a copy icon](https://content.gitbook.com/content/J8asLD4FVCFagK40xEr4/blobs/mqR37HR0WR4mZMkRHfdG/frame_003.jpg)

Klaviyo warns that this is the only time the full private key is visible. If you lose it, you’ll need to create a new one.
{% endstep %}

{% step %}

#### Step 3: Paste the API key into Roadmap

Open the Klaviyo tab in Roadmap Settings

Back in Shopify (Roadmap), go to **Settings** and select the **Klaviyo** tab.

Paste your key into **Klaviyo API Key**, then click **Save**.

![Roadmap Settings with the Klaviyo tab and the Klaviyo API Key field plus Save button](https://content.gitbook.com/content/J8asLD4FVCFagK40xEr4/blobs/tbguxgRDrgirYgwwrzF5/frame_004.jpg)
{% endstep %}

{% step %}

#### Step 4: Sync Roadmap data to Klaviyo

Open Klaviyo Integration

In the Roadmap left menu, click **Klaviyo Integration**.

![Roadmap in Shopify showing the Settings page and the Klaviyo Integration item in the left navigation](https://content.gitbook.com/content/J8asLD4FVCFagK40xEr4/blobs/pcdpTB6uF3kOyYi3btKw/frame_005.jpg)

Sync profile properties

On **Klaviyo Integration**, select **Klaviyo Profile** to sync Roadmap profile properties into Klaviyo profiles (useful for segmentation and personalization).

![Roadmap Klaviyo Integration screen with Klaviyo Profile and Klaviyo Metrics options](https://content.gitbook.com/content/J8asLD4FVCFagK40xEr4/blobs/CVkxpkuALpcnTwj1C8UN/frame_006.jpg)

Sync metrics for flows

Select **Klaviyo Metrics** to sync Roadmap metrics used by Klaviyo **Flows**. This is where you manage which Roadmap data points appear as usable flow triggers/filters in Klaviyo.

![Klaviyo Integration view showing the Klaviyo Metrics option for syncing data used in flows](https://content.gitbook.com/content/J8asLD4FVCFagK40xEr4/blobs/hlDKPCSpiUusAtF0SvQJ/frame_007.jpg)
{% endstep %}

{% step %}

#### Step 5: Confirm your flows are ready

When you’ve finished syncing, you’ll see a confirmation screen indicating you’re ready to begin setting up your Klaviyo flows.

![Confirmation screen stating the Klaviyo flows setup is complete](https://content.gitbook.com/content/J8asLD4FVCFagK40xEr4/blobs/uCfAIu4jtkHt0EkRQAHi/frame_008.jpg)

If your synced metrics or profile properties don’t appear in Klaviyo right away, re-check that your **Klaviyo API Key** is saved in Roadmap ( **Settings** → **Klaviyo**) and that you enabled sync under **Klaviyo Integration**.
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.roadmap.so/reviews/integrations/klaviyo-review-integration/how-to-integrate-roadmap-with-klaviyo.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.