Setup Klaviyo Integration

Klaviyo is a powerful email marketing platform built for e-commerce. This guide shows you how to integrate Klaviyo with Qivra Form Builder to sync customer data and automate marketing.

What This Integration Does

Feature	Description
Profile Sync	Add form submitters as Klaviyo profiles
List Management	Add contacts to specific Klaviyo lists
Event Tracking	Track form submissions as events
Marketing Automation	Trigger Klaviyo flows from forms

Prerequisites

Before setting up Klaviyo:

1. Have a Klaviyo account
2. Know which List to use
3. Have API key ready

Getting Klaviyo API Key

Step 1: Get Your Klaviyo 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.

Tip

Permissions granted to the API key:

Read: Accounts
Full access: List, and Profiles

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 Qivra Form Builder

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

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

Step 3: Choose Your Klaviyo List

1. Open the app > click Forms > open the form you want to deal with
2. Click Integration on the settings > turn on Klaviyo option > click on the kalviyo option

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. Example: Map the “First Name” field in your form to the “First Name” property in Klaviyo

Step 5: Publish & Test Your Form

If the form is published, you just need to save the form after you make changes.

How It Works

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

How to check the Klaviyo list:

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.

Event Tracking

Track Form Submissions

Send events to Klaviyo when forms are submitted:

1. Enable Track Events in settings
2. Set event name (e.g., “Form Submitted”)
3. Include event properties

Event Properties

Include submission data in events:

Property	Description
Form Name	Which form was submitted
Form ID	Unique form identifier
Submission Data	Selected field values

Using Events in Flows

Create Klaviyo flows triggered by form submissions:

1. In Klaviyo, go to Flows
2. Create new flow
3. Trigger: “Metric” > Select your form event
4. Build your automation

Per-Form Settings

Different Lists per Form

Use different lists for different forms:

1. Open form in Form Builder
2. Go to Settings > Integrations
3. Select Klaviyo
4. Choose specific list

Form-Specific Events

Track different events for different forms:

Form	Event Name
Contact Form	”Contact Form Submitted”
Newsletter	”Newsletter Signup”
Wholesale	”Wholesale Inquiry”

Custom Profile Properties

Add custom properties to profiles:

1. Map additional form fields
2. Create custom properties in Klaviyo
3. Use for segmentation

Sync Behavior

Profile Creation

When form is submitted:

1. Klaviyo checks for existing profile (by email)
2. Creates new profile or updates existing
3. Adds to specified list
4. Records event if enabled

Update Settings

Setting	Behavior
Update existing	Overwrites profile data
Merge data	Adds new data, keeps existing
Skip existing	No updates to existing profiles

Consent Management

Handle email consent:

1. Set consent status when syncing
2. Track subscription source
3. Honor unsubscribe requests

Klaviyo Segmentation

Using Form Data for Segments

Create segments based on form submissions:

Properties about someone > Form Source > equals > "Contact Form"

Using Events for Segments

Segment by form submission events:

Someone did "Form Submitted" > at least once > in the last 30 days

Using Tags

Add tags for easy segmentation:

1. Include tags in profile properties
2. Create tag-based segments
3. Target specific audiences

Troubleshooting

Profiles Not Syncing

Cause	Solution
Invalid API key	Verify and re-enter key
Missing email	Ensure form has email field
Wrong list ID	Verify list selection
API scopes	Check key has required scopes

Field Mapping Issues

Issue	Solution
Property not syncing	Check mapping is correct
Wrong data type	Ensure types match
Custom properties	Create in Klaviyo first

Rate Limits

Klaviyo API limits:

Tier	Requests/second
Free	10
Paid	Varies by plan

Klaviyo Pricing Considerations

Profile Limits

Plan	Profiles
Free	250
Email	Varies
Email & SMS	Varies

Check Klaviyo pricing for current limits.

Best Practices

List Hygiene

• Clean inactive profiles regularly
• Remove bounced emails
• Honor unsubscribes promptly

Segmentation Strategy

• Use meaningful tags
• Create clear segments
• Target relevant audiences

Automation Setup

• Create welcome flows for new contacts
• Set up follow-up sequences
• Track conversion metrics

Video Tutorial

Play

Related Docs

• Email Notification Settings
• Setup Mailchimp
• Field Types Reference