Note: Integrations must be set up by a Toolkit admin. To connect any of the integrations below, contact support and let us know which integration you'd like added to your account.

Klaviyo Integration

Connect Popup with Klaviyo to manage subscriber lists, custom fields, and targeted Display Rules based on list membership.

Getting Your API Key

Klaviyo requires a custom Private API Key with specific permissions:

1. In your Klaviyo account, go to Settings > API Keys
2. Create a new Private API Key
3. Grant the key Read/Write access to the following scopes:

• List
• Profiles
• Subscriptions

1. Copy the key

Connecting Klaviyo to Popup

1. In your Popup dashboard, go to your site's Integrations settings
2. Select Klaviyo from the list
3. Paste your Private API Key and save

Auto Field Mapping

Popup automatically maps your widget form fields to matching Klaviyo profile properties. If a field name matches a Klaviyo property, the mapping is set up for you.

Configuring Your Widget

Once connected, open your widget editor and configure the submit actions.

Available Actions

• Add subscriber to list -- add the contact to a specific Klaviyo list
• Remove subscriber from list -- remove the contact from a list
• Update custom field -- set or update a custom profile property

Display Rules

Use Display Rules to show or hide widgets based on whether a visitor is already subscribed to a specific Klaviyo list. This lets you avoid showing opt-in forms to existing subscribers or show targeted offers to specific segments.

Visitor Identification

To identify returning visitors by email (for personalized Display Rules), append the email parameter to your URLs in Klaviyo emails:

?conv_email=

When a subscriber clicks through from a Klaviyo email, Popup recognizes them and applies the appropriate Display Rules.

Need more help?

If you've worked through this and still need a hand, contact support -- we'll dig in with you.