> For the complete documentation index, see [llms.txt](https://docs.powerfulform.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.powerfulform.com/app-integration/klaviyo-integration.md).

# Klaviyo integration

### ✅ What You Can Do

With this integration, you can:

* Add customers to a Klaviyo list
* Collect new subscribers directly from your forms
* Store additional profile data (first name, last name, phone, custom fields, etc.)
* Maintain accurate, real-time audience data

***

### 📝 Step 1: Get Your Klaviyo Private API Key

To connect Klaviyo, you need your **Private API Key**.

1. Log in to your Klaviyo account.
2. Navigate to **Account** > **Settings** > **API Keys**.
3. Click **Create Private API Key**.
4. Copy the generated key for use in the next step.

> Permissions granted to the API key:
>
> **Read: Accounts and Forms**\
> **Full Access: List and Profiles, Subscriptions**

Reference: <https://help.klaviyo.com/hc/en-us/articles/115005062267-Manage-Your-Account-s-API-Keys>

**Note**: Ensure you use a private API key, as public keys are not supported for this integration.

***

### 📝 Step 2: Add API Key to Powerful Form Builder

1. Open the app > click **Settings** > **Third party integration** > hover **Klaviyo** > click **Config**

<figure><img src="/files/uPksuv5pAFv9FL95wbsJ" alt=""><figcaption></figcaption></figure>

2. In **Klaviyo API key** field, paste the API key created in the step 1

<figure><img src="/files/EXOxI0f4KQkC5OrqyjhT" alt=""><figcaption></figcaption></figure>

3. Click **Save** to updated the changes

***

### 🧾 Step 3: Choose Your Klaviyo List

1\. Open the app > click **Forms** > open the form you want to deal with

2\. Click **Integration** icon on the left side > turn on Klaviyo option > click on the kalviyo option

<figure><img src="/files/sTRmZt9fv7gf0imIPSTA" alt=""><figcaption></figcaption></figure>

3\.  Select a contact list (from Klaviyo) in **List** dropdown

<figure><img src="/files/pR5I4Y6Whv8etknmotOt" alt=""><figcaption></figcaption></figure>

***

### 📝 Step 4: Map Your Form Fields to Klaviyo Properties

* The **Email** field is mandatory to create a new profile in Klaviyo
* Optional fields like **First Name**, **Last Name**, etc., can be mapped as needed. Exampl&#x65;*:* Map the "First Name" field in your form to the "First Name" property in Klaviyo

<figure><img src="/files/pR5I4Y6Whv8etknmotOt" alt=""><figcaption></figcaption></figure>

***

### 📝 Step 5: Publish & Test Your Form

If the form is published, you just need to save the form after you make changes.&#x20;

***

### ✅ How It Works <a href="#how-it-works" id="how-it-works"></a>

1. A customer submit the form.&#x20;
2. Customer email address is added to the Klaviyo list.&#x20;

<figure><img src="/files/llHVXDvayPNeazxHQyLU" alt=""><figcaption></figcaption></figure>

How to check the Klaviyo list:&#x20;

1. Log in to your Klaviyo account > go to **Audience** > **Lists & Segments**.
2. Open the list you integrated with your form > Check for the new subscriber profile to confirm data has been added successfully.
3. You can create the flow with the selected it in your Klaviyo account.

***

### 🔧 Troubleshooting

#### ❌ Profile not showing in Klaviyo

Check the following:

1. API key is correct
2. List is selected
3. Email field is mapped to **email**
4. &#x20;This could be due to the opt-in settings in Klaviyo:

* **Single Opt-In**: Subscribers are added immediately without confirmation. This is recommended for seamless integration.
* **Double Opt-In**: Subscribers must confirm their subscription via email. If they don't, their data won't appear in Klaviyo.

**Note**: The app cannot bypass Klaviyo's double opt-in process. **Single Opt-In** is recommended.

In account **Setttings:**

<figure><img src="/files/svQkWivvS4Xbmm5NdSCR" alt=""><figcaption></figcaption></figure>

In **List Settings:**

<figure><img src="/files/U9YWuIEo2tSPX5wTgSwr" alt=""><figcaption></figcaption></figure>

#### ❌ “List not found” or empty list dropdown

Try:

* Regenerating a new Private API Key
* Ensuring you have at least one active list in Klaviyo
* Checking permissions (API key needs profile/list access).&#x20;

***

### ❓ FAQs

#### **Can I add customers to multiple lists?**

Not automatically.\
A form can sync to **one list at a time**, but your Klaviyo flows can route profiles to other lists afterward.

#### **Can I sync phone numbers?**

Yes.\
Map your form’s **Phone** field to `phone_number`.

#### **Can I update existing Klaviyo profiles?**

Yes.\
If an email already exists, the app will **update** the profile with new data.

#### **Can I trigger a Klaviyo flow after form submission?**

Yes.\
Set your flow trigger to:\
✔ Added to list\
or\
✔ Profile property updated

#### **Is a Klaviyo account required?**

Yes, you must have a Klaviyo account with at least one list.

#### **What happens if the customer does not enter an email?**

Klaviyo requires an email address.\
Without it, the submission cannot be added to Klaviyo.

***

#### Need More Help?

If you still need assistance, please contact us at <contact@globo.io>. Our team will be happy to help you resolve any issues or guide you further.