Skip to content
Qivra Help Center

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

Section titled “What This Integration Does”
FeatureDescription
Profile SyncAdd form submitters as Klaviyo profiles
List ManagementAdd contacts to specific Klaviyo lists
Event TrackingTrack form submissions as events
Marketing AutomationTrigger Klaviyo flows from forms

Prerequisites

Section titled “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

Section titled “Getting Klaviyo API Key”

Step 1: Log in to Klaviyo

Section titled “Step 1: Log in to Klaviyo”
  1. Go to klaviyo.com
  2. Sign in to your account

Step 2: Access API Settings

Section titled “Step 2: Access API Settings”
  1. Click your account name (bottom left)
  2. Go to Settings > API Keys

Step 3: Create API Key

Section titled “Step 3: Create API Key”
  1. Click Create API Key
  2. Name it (e.g., “Qivra Form Builder”)
  3. Select Private API Key
  4. Add required scopes:
    • lists:read
    • lists:write
    • profiles:read
    • profiles:write
    • events:write (optional)
  5. Click Create
  6. Copy the API key

Finding Your List ID

Section titled “Finding Your List ID”

Step 1: Go to Lists

Section titled “Step 1: Go to Lists”
  1. In Klaviyo, click Audience
  2. Click Lists & Segments

Step 2: Select List

Section titled “Step 2: Select List”
  1. Find your target list
  2. Click to open it

Step 3: Get List ID

Section titled “Step 3: Get List ID”
  1. Click Settings
  2. Copy the List ID

The List ID looks like: ABC123

Configuring Klaviyo in Qivra Form Builder

Section titled “Configuring Klaviyo in Qivra Form Builder”

Step 1: Open Settings

Section titled “Step 1: Open Settings”
  1. Go to Qivra Form Builder
  2. Click Settings in sidebar
  3. Go to Providers section

Step 2: Select Klaviyo

Section titled “Step 2: Select Klaviyo”
  1. Find Klaviyo in the provider list
  2. Click to select it

Step 3: Enter API Key

Section titled “Step 3: Enter API Key”
  1. Paste your Klaviyo API key
  2. Click Connect

Step 4: Select List

Section titled “Step 4: Select List”
  1. Choose your target List from dropdown
  2. This is where contacts will be added

Step 5: Field Mapping

Section titled “Step 5: Field Mapping”

Map form fields to Klaviyo profile properties:

Form FieldKlaviyo Property
Email$email (required)
First Name$first_name
Last Name$last_name
Phone$phone_number
CompanyOrganization
City$city
Country$country

Step 6: Save Settings

Section titled “Step 6: Save Settings”
  1. Click Save
  2. Test the connection

Event Tracking

Section titled “Event Tracking”

Track Form Submissions

Section titled “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

Section titled “Event Properties”

Include submission data in events:

PropertyDescription
Form NameWhich form was submitted
Form IDUnique form identifier
Submission DataSelected field values

Using Events in Flows

Section titled “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

Section titled “Per-Form Settings”

Different Lists per Form

Section titled “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

Section titled “Form-Specific Events”

Track different events for different forms:

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

Custom Profile Properties

Section titled “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

Section titled “Sync Behavior”

Profile Creation

Section titled “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

Section titled “Update Settings”
SettingBehavior
Update existingOverwrites profile data
Merge dataAdds new data, keeps existing
Skip existingNo updates to existing profiles
Section titled “Consent Management”

Handle email consent:

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

Klaviyo Segmentation

Section titled “Klaviyo Segmentation”

Using Form Data for Segments

Section titled “Using Form Data for Segments”

Create segments based on form submissions:

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

Using Events for Segments

Section titled “Using Events for Segments”

Segment by form submission events:

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

Using Tags

Section titled “Using Tags”

Add tags for easy segmentation:

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

Testing the Integration

Section titled “Testing the Integration”

Test Submission

Section titled “Test Submission”
  1. Submit a test form with valid email
  2. Check Klaviyo Profiles
  3. Verify profile created with correct data

Check List Membership

Section titled “Check List Membership”
  1. Go to target list in Klaviyo
  2. Find the test profile
  3. Confirm they’re added to list

Verify Event Tracking

Section titled “Verify Event Tracking”
  1. Go to profile’s activity feed
  2. Look for form submission event
  3. Check event properties

Troubleshooting

Section titled “Troubleshooting”

Profiles Not Syncing

Section titled “Profiles Not Syncing”
CauseSolution
Invalid API keyVerify and re-enter key
Missing emailEnsure form has email field
Wrong list IDVerify list selection
API scopesCheck key has required scopes

Field Mapping Issues

Section titled “Field Mapping Issues”
IssueSolution
Property not syncingCheck mapping is correct
Wrong data typeEnsure types match
Custom propertiesCreate in Klaviyo first

Rate Limits

Section titled “Rate Limits”

Klaviyo API limits:

TierRequests/second
Free10
PaidVaries by plan

Klaviyo Pricing Considerations

Section titled “Klaviyo Pricing Considerations”

Profile Limits

Section titled “Profile Limits”
PlanProfiles
Free250
EmailVaries
Email & SMSVaries

Check Klaviyo pricing for current limits.

Best Practices

Section titled “Best Practices”

List Hygiene

Section titled “List Hygiene”
  • Clean inactive profiles regularly
  • Remove bounced emails
  • Honor unsubscribes promptly

Segmentation Strategy

Section titled “Segmentation Strategy”
  • Use meaningful tags
  • Create clear segments
  • Target relevant audiences

Automation Setup

Section titled “Automation Setup”
  • Create welcome flows for new contacts
  • Set up follow-up sequences
  • Track conversion metrics

Video Tutorial

Section titled “Video Tutorial”
Play
Section titled “Related Docs”