> For the complete documentation index, see [llms.txt](https://docs.rhym.io/rhym-help-guide-and-faqs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rhym.io/rhym-help-guide-and-faqs/integrations/integration-with-klaviyo.md).
# Integration with Klaviyo
Connect Klaviyo to your Rhym account once and any campaign you publish can push leads directly into the Klaviyo list of your choice. The recommended path is to **Connect with Klaviyo** (OAuth) - one click, no copying keys around. If you'd rather not authorize via OAuth, you can still paste a Private API Key per campaign - see the alternative at the bottom.
> **NOTE: Klaviyo needs at least one of Name, Email, or Phone Number from your lead form.** If your campaign doesn't have a Lead Form yet, [add one first](https://docs.rhym.io/rhym-help-guide-and-faqs/how-to-create-campaign/basics-of-editor/adding-lead-form-to-capture-leads).
## 1. Open the Klaviyo Integration page
Click your avatar in the top-right → **Account Settings** → scroll to the **Integrations** card → click **Manage** next to Klaviyo. (You can also navigate directly to `/integrations/klaviyo`.)
## 2. Connect with Klaviyo
If you're not connected yet, the page shows a **Not Connected** state with a **Connect with Klaviyo** button.
Click **Connect with Klaviyo**. You'll be redirected to Klaviyo's authorize page - sign in to your Klaviyo account and click **Allow** to grant Rhym access to your lists.
Once you authorize, Klaviyo sends you back to Rhym and the page now shows **Connected**. From here you can also **Reconnect** (rotate tokens) or **Disconnect** at any time.
You only do this once - the connection works across every campaign in your account.
## 3. Add Klaviyo to your campaign
Open the game editor for the campaign you want to wire up. Click **Add Integrations** in the header, then click **Klaviyo**.
## 4. Pick your list and enable consent
The Klaviyo modal opens. Because you're already OAuth-connected, the modal shows a **searchable List dropdown** populated from your Klaviyo account - start typing to filter by list name or ID. Pick the list you want this campaign's leads to sync into.
A few details:
* **Email Marketing Consent** - if toggled on, profiles are added with marketing consent set to `SUBSCRIBED`. Make sure your Lead Form makes consent clear (a Terms & Conditions checkbox like *"I agree to receive marketing content"*, or an inline notice such as *"By providing your email you agree to receive marketing content"*).
* Toggle the **Klaviyo** switch at the top of the modal to make the integration **Active**.
* Click **Update**. From now on, every lead submitted on this campaign is pushed to your selected Klaviyo list in real time.
## 5. Manage or Disconnect
You can open the same Integration page any time - either from **Account Settings → Integrations → Klaviyo → Manage**, or by clicking **Manage Klaviyo** at the top of the per-game Klaviyo modal.
* **Reconnect** rotates your tokens (useful if you suspect they've been compromised).
* **Disconnect** revokes Rhym's access on Klaviyo's side and clears the connection on this Rhym account. Any campaigns wired to push via OAuth will stop syncing until you reconnect.
## 6. (Alternative) Connect with an API key
If you'd rather not authorize through Klaviyo, the per-game modal also lets you paste a **Private API Key** and pick a List ID directly. In the Klaviyo modal, click **Connect using API key instead** to switch to the API-key form.
* Generate / locate your Private API Key in Klaviyo - see [How to Manage Your Account's API Keys](https://help.klaviyo.com/hc/en-us/articles/115005062267-How-to-Manage-Your-Account-s-API-Keys).
* Paste the key, click **Get Lists**, pick the list, toggle **Email Marketing Consent** as appropriate, switch Klaviyo to **Active**, and click **Update**.
The API-key path stays available as a fallback - existing campaigns wired this way keep working unchanged.
## 7. How to verify it's working
Publish your campaign (or use the Preview link) and submit a test lead through the Lead Form.
Within a few seconds the profile should appear in the Klaviyo list you picked - with `Email Marketing Consent = SUBSCRIBED` applied if you enabled that toggle. If the lead doesn't show up:
* Confirm the Klaviyo switch at the top of the modal is **Active**.
* Confirm `/integrations/klaviyo` still shows **Connected** (for OAuth) or that your Private API Key is still valid (for the API-key path).
* Make sure your Lead Form actually collects an Email or Phone Number - Klaviyo needs at least one identifier.
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.rhym.io/rhym-help-guide-and-faqs/integrations/integration-with-klaviyo.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.