Skip to Content

Klaviyo

Sync customer profiles to Klaviyo for email and SMS marketing automation. Keep your Klaviyo profiles and lists in sync with your warehouse data.

Prerequisites

  • A Klaviyo account
  • A Klaviyo private API key (starts with pk_)

Authentication

Klaviyo uses Private API Key authentication.

  1. In Klaviyo, go to Settings > API keys
  2. Create a new private API key
  3. Copy the key (starts with pk_)
  4. Paste it into the Private API Key field in Zeotap

Configuration

FieldTypeRequiredDescription
API RevisionTextNoKlaviyo API revision date. Default: 2024-02-15

Target Settings

FieldTypeRequiredDescription
List IDTextNoExisting Klaviyo list ID. Leave blank to use List Name for auto-creation.
List NameTextNoName of the list to sync to. A new list is created if List ID is blank.

Supported Operations

Sync Modes: Upsert, Insert

Audience Sync Modes: Add, Remove, Mirror, Upsert

Features

  • Field Mapping: Yes
  • Schema Introspection: No

Required Mapping Fields

FieldDescription
emailPrimary profile identifier

Default Destination Fields

email, phone_number, external_id, first_name, last_name, title, organization, city, region, country, zip, image, latitude, longitude

Troubleshooting

Invalid API key format

Klaviyo private API keys must start with pk_. Public API keys (starting with other prefixes) cannot be used for server-side operations.

List not found

If specifying a List ID, verify it in Klaviyo under Audience > Lists & Segments. The List ID is visible in the list URL.

Profile not updating

Klaviyo identifies profiles by email. Ensure the email field is correctly mapped and contains valid email addresses.

Last updated on