Welcome to the Klaviyo Connector setup guide! This document serves as a comprehensive guide for configuring Klaviyo to integrate seamlessly with Savant using the methods mentioned below.
Features
Sync data from Klaviyo to Savant, including campaigns, events, and metrics.
Read and write access to Klaviyo's objects such as Persons, Lists, Events, and Campaigns.
Leverage Klaviyo's APIs for advanced tracking and profile management.
Requirements
To establish a connection between Savant and Klaviyo, the following prerequisites must be met:
Access to valid Klaviyo API credentials:
Private API Key: Enables secure access to Klaviyo data.
Public API Key (Site ID): For unique identification of your account.
Familiarity with Klaviyo's data model, including objects such as Metrics, Events, Campaigns, and Lists.
Option to create a Klaviyo sandbox account for development and testing purposes.
Connection Methods
Savant supports secure access to Klaviyo using the following:
API Key Authentication
External ID (Public API Key)
Follow this guide to set up and configure the integration.
API Key Authentication
Step 1: Generate API Keys in Klaviyo
Log in to your Klaviyo account and navigate to the API Keys Section.
Generate the following keys:
Private API Key: Provides access to Klaviyo data.
Public API Key (Site ID): Used for account identification.
Save these keys securely, as they will be required to set up the connection in Savant.
Step 2: Authenticate in Savant
Go to Systems in Savant and click Add System.
Select the Klaviyo Connector and click Next.
Enter the following details:
Private API Key
Public API Key (Site ID)
Click Authenticate to confirm the connection.
Supported Data Model
Objects and Fields
Metrics: Stores metrics for various events.
id(Primary Key): Metric Unique Identifier.name: Name of the metric.updated: Last updated timestamp.created: Creation timestamp.
Persons: Represents profile information of accounts.
Fields such as
id,first_name,last_name,email,organization,created,updated.
Events: Tracks account-level activities and campaign information.
Fields include
id,person_id,campaign_id,datetime,event_properties.
Campaigns: Represents campaigns created within the Klaviyo account.
Fields include
id,name,subject,status,sent_at,email_template_id.
Lists: Includes subscriber lists within Klaviyo.
Fields include
id,list_name,folder_name,created,updated.
Supported Schema, Objects, and Fields
Schema | Object | Fields (Data Type) |
Persons | Profile Information | See Notes Below |
Metrics | Metric Information | See Notes Below |
Events | Campaign Events | See Notes Below |
Lists | Subscriber Lists | See Notes Below |
Campaigns | Campaigns and Flows | See Notes Below |
Field Examples:
id(Text)name(Text)created(DateTime)updated(DateTime)email_template_id(Text)event_properties(JSON)
Troubleshooting
Invalid Authentication: Ensure the correct Private and Public API keys are entered during setup.
Data Model Mismatch: Verify the object mappings between Savant and Klaviyo's API documentation.
API Limits: Monitor your account's API rate limits to avoid interruptions.