Klaviyo

Use GrowthLoop audiences and warehouse profile data for Klaviyo lists and identity profiles.

Connect this destination to export audience membership into a Klaviyo list, or to write warehouse rows onto existing Klaviyo identity profiles, for use in Klaviyo campaigns.

This destination writes to your Klaviyo account and is a good fit when you want to:

  • Make GrowthLoop audiences available as Klaviyo lists
  • Update identity profiles that already exist in Klaviyo

This maps to GrowthLoop Audiences, Journeys, and Syncs:

Use it forAudiencesJourneysSyncs
Sending GrowthLoop audiences to Klaviyo lists✓✓
Updating existing Klaviyo profiles from a warehouse table✓

Prerequisites

Make sure you have:

  • A Klaviyo account with permission to view or create an API key. Owner, Admin, or Manager roles can view and create API keys.
  • A Klaviyo API key. Find it in account settings, or create one with Create API KEY.

Set up Klaviyo as a destination

  1. In GrowthLoop, click the Destinations tab on the left sidebar.
  2. Click New Destination in the upper right corner.
  3. Search for Klaviyo and click Add Klaviyo.
  4. Enter the required information, then click Create.
FieldDescription
Destination NameName this destination in GrowthLoop. Use a name so your team recognizes its purpose, like "Klaviyo Email".
Sync FrequencySet the default export frequency to Hourly or Daily. You can override this setting for individual exports and syncs.
API KeyAPI key you've created in your Klaviyo account settings.
Prefix for Personalization Fields (optional)Prefix GrowthLoop adds to personalization fields. The default value is fw. Leave this blank for no prefix. If you set one, it must start with a letter and use up to 5 letters or numbers.

GrowthLoop validates the connection by listing Klaviyo lists. Klaviyo then appears in your list of connected destinations.

Export to Klaviyo

From within GrowthLoop, export from an audience or from a journey Destination Node. See Export an audience or Build a journey if you need more information on these steps.

After building or selecting an audience, click Export, then search for Klaviyo. In a journey, add a Destination Node under Email and select Klaviyo.

Journey Destination Node with export name, match fields, and personalization signals

Map contact identifiers

On an audience or in a journey Destination Node, map Email address and/or Phone. GrowthLoop needs at least one to match the Klaviyo profile.

Configure the export

This is where you set the campaign type and schedule for audience exports. On a journey Destination Node, you set timing on the journey canvas.

SettingAudience exportJourney Destination Node
Export NameDefaults to {audience name}_GL_Audience_{audience ID}. That is the Klaviyo list name unless you change it.Required. Enter a name so you can find the export in GrowthLoop and the list in Klaviyo.
Campaign typeChoose a one-time or ongoing export.The journey schedule controls when the journey runs and contacts are sent to Klaviyo.
ScheduleSet frequency, start date, end date, and days of the week for ongoing exports.Users reach this node when the journey runs. Add a Delay Node or set Criteria Evaluation to control timing.

Export behavior

This is what GrowthLoop writes when you export an audience.

BehaviorWhat happens
What GrowthLoop writesMembership on a Klaviyo list under Lists & Segments. Direction is GrowthLoop → Klaviyo.
When it runsGrowthLoop sends the export as a batch on the next successful run. An export that starts Now runs within about 15 minutes. Journeys send exports on demand when users reach the Destination Node.
ListGrowthLoop creates or reuses a list named after the export name.
Match fieldsEmail address and/or Phone.
AddGrowthLoop bulk-imports the profile and adds it to the list. If the profile does not exist, Klaviyo can create it.
One-time exportsGrowthLoop adds current members to the list.
Ongoing adds and removalsOngoing exports add contacts who enter the audience and remove contacts who leave the list.
DeletesGrowthLoop does not delete Klaviyo profiles. Remove only takes the contact off the list.

Create a sync in GrowthLoop

Create a sync from a warehouse table to write rows onto existing Klaviyo identity profiles. See Syncs for information on how to complete those steps.

Select an Object Type:

ObjectUse it forSync modes
IdentityUpdate existing Klaviyo profilesInsert, Update, or Insert or update

When you configure the sync:

  • Connection: Select your Klaviyo destination.
  • Object Type: Select Identity.
  • Update Rule: The sync UI offers Insert, Update, or Insert or update. GrowthLoop updates profiles that already exist in Klaviyo. See Sync behavior.
  • Dataset/Table: Select the warehouse table that holds the records.
  • Match Field: Map Email or Phone. Map Email so GrowthLoop can look up the profile.

After you map fields, click Update Sync. Enable the sync with the toggle at the top of the page.

Syncs update identity profiles. They do not add or remove contacts from a Klaviyo list. To manage list membership, export an audience.

Identity fields

Map Email or Phone, then map the profile fields you want to write.

Destination fieldDescription
Email or Phone NumberRequired. Map at least one. GrowthLoop looks up the profile by email
First Name, Last Name, City, Region, Country, Image, ConsentOptional profile fields

Sync behavior

BehaviorWhat happens
When it runsGrowthLoop sends the sync as a batch on the next successful run.
Profile writeGrowthLoop looks up the Klaviyo profile and updates mapped fields. New profiles are not created.
Profile matchMap Email or Phone. Lookup uses email.
List membershipSyncs do not add or remove contacts from a Klaviyo list.
DeletesGrowthLoop does not delete Klaviyo profiles.

Rows without Email or Phone fail.

Confirm the export was successful

When the run finishes, confirm you can use the data in Klaviyo.

  • Audience export: Open Lists & Segments and look up the list. Look for the _GL_Audience_ name unless you changed Export Name.
  • Journey Destination Node: Open Lists & Segments and look up the list named after the export.
  • Identity sync: Search for a profile that already exists in Klaviyo and check the mapped fields.

In GrowthLoop, review Added and Removed counts on the audience Exports tab, open the Activity tab on the journey Destination Node, or confirm the sync appears in the Syncs table. See Export an audience, Monitor a journey, or Syncs for more information.

Congrats on successfully exporting to Klaviyo!

Troubleshooting

These are the issues we see most often. You can always email us at [email protected] for help.

ProblemCauseResolution
Connection fails to validateThe API key is wrong, or your Klaviyo role cannot create keysConfirm the API key in Klaviyo account settings. Ask an Owner, Admin, or Manager to create a key if you cannot see one
Rows fail to match on an exportEmail and Phone are both unmappedMap Email address and/or Phone
An identity sync does not create a new profileSyncs update existing Klaviyo profiles onlyExport an audience if you need Klaviyo to create the profile on list add. For a sync, map Email to a person who already exists in Klaviyo
An identity sync fails to matchEmail is not mapped, or the profile does not existMap Email and confirm the person already exists in Klaviyo
A sync did not change a listSyncs update identity profiles onlyExport an audience to add or remove list membership

What’s Next

Export an audience after you connect a destination

Did this page help you?