Platform 2 Guide — This article applies to the new platform. Looking for classic platform docs? Browse the Platform 1 collection.
Why: Connect your app with Klaviyo to seamlessly sync subscribers and manage list memberships based on app events. This integration helps you enhance your marketing efforts by ensuring your members receive targeted communications.
Navigate: App Station > Settings > Integrations > Klaviyo
Quick Start
Click the Klaviyo option in the Integrations section.
Enter your private API key in the API key input field.
Click the Test Connection button to verify the API key.
Configure your event-to-list mappings for the desired app events.
Toggle the Profile Data Sync option to enable syncing of member profile data.
Detailed Setup Instructions
Step 1: Enter Your API Key
To connect Klaviyo to your app, you need to create a private API key in your Klaviyo account.
Log in to your Klaviyo account.
Navigate to Settings > Account > API Keys.
Click Create API Key and select Custom Key.
Enable the following scopes:
Accounts: Read Access
List: Full Access
Profiles: Full Access
Subscriptions: Full Access
Copy the generated API key.
Now, return to your app's Klaviyo integration settings.
In the API key input field, paste your copied API key.
Click the Test Connection button to ensure the key is valid.
Step 2: Configure Event-to-List Mappings
Once your API key is validated, you can set up how app events correspond to Klaviyo lists.
In the Klaviyo integration settings, you'll see a list of supported events.
For each event, select the corresponding Klaviyo lists to add or remove profiles.
For example, map the
user.signed_upevent to your "Members" list.
The settings will auto-save as you make changes.
Step 3: Enable Profile Data Sync
To ensure that member profile information is kept up to date in Klaviyo, enable the profile data sync option.
Toggle the Profile Data Sync option to "On."
This will allow specific member data to sync automatically, enhancing your marketing capabilities.
Step 4: Manage Email Marketing Consent
By default, profiles added to Klaviyo lists are not subscribed for email marketing. If you want to change this behavior:
Toggle the Subscribe profiles for email marketing option to "On."
This will ensure that profiles are subscribed for email marketing when added to lists.
Note: Make sure you have obtained proper consent from your members before enabling this option.
Supported Events and Their Uses
Here are some key events you can map to Klaviyo lists:
user.signed_up: Adds new members to your members list.checkout.completed: Adds purchasers to your purchasers list.subscription.started: Adds members to your paid-members list.subscription.canceled: Adds members to a win-back list.access.granted: Adds members to an access-tier list.
For a complete list of events and their mappings, refer to the Klaviyo integration settings page.
Testing Your Integration
After setting everything up, it’s a good idea to test the integration to ensure everything is working as expected. You can do this by performing actions in your app that trigger the mapped events and checking if they reflect in your Klaviyo account.