---
title: Klaviyo
slug: aI8D-klaviyo
docTags: 
createdAt: 2025-05-09T18:42:32.311Z
---

# Introduction

Klaviyo is a marketing automation platform built specifically for e-commerce brands, designed to help them deliver personalized customer experiences through email and SMS. It empowers marketers to build targeted campaigns, automate messaging flows, and measure performance using rich customer data. By integrating directly with e-commerce platforms and pulling in behavioral and transactional data, Klaviyo enables brands to turn insights into action—driving higher engagement, loyalty, and revenue.

# Getting started

Before connecting your Klaviyo account as a CDP destination, a custom ***Private API Key*** must be generated with a specific set of configured scopes:



::Image[]{src="https://api.archbee.com/api/optimize/TmutqdeXiIw-V3gBZXVjd/XqYoeOqe3OBdoRcxm2aPO_image.png" size="80" width="3174" height="1804" position="center" darkWidth="3174" darkHeight="1804" showCaption="false"}

Once you have navigated to create a new private API Key (*Settings *> *Account* > *API Keys*), the scopes to configure are:

- **Events API **scope must be set to `Read/Write Access`
- All other API scopes can be set to `Read Access`

::Image[]{src="https://api.archbee.com/api/optimize/VPxpEoMPxDsnmxOyjOdWV-ATniMZHlo2xXr5SwGVX5x-20250514-215853.png" size="80" width="2890" height="1558" position="center" darkWidth="2890" darkHeight="1558" showCaption="false"}

Once configured, click **Create** in the top-right corner. The API key permissions for you newly created key will appear as follows: 

::Image[]{src="https://api.archbee.com/api/optimize/VPxpEoMPxDsnmxOyjOdWV-sPZrWt135KCw2i487GaRk-20250514-220026.png" size="48" width="1398" height="428" position="center" darkWidth="1398" darkHeight="428" showCaption="false"}

# Connecting to the Klaviyo CDP destination

1. Log into the Chord data platform.
2. Navigate to the CDP.
3. Click the **"Add" **button next to Destinations.
4. Select **Klaviyo** from the destination catalog.
5. Enter in the destination name and the** Klaviyo** API key.
6. Click **"Create"** to connect.

# Chord events relevant for destination

While typically not all Chord Tracking events are used downstream in your configured destinations, Klaviyo is an exception. As a SMS and email marketing platform, Chord passes through all availalbe/possible *track* events that are passed through any configured sources upstream. **All track events are sent to Klaviyo's [Custom Events API](https://developers.klaviyo.com/en/reference/events_api_overview) with their original name.**

The use cases supported by Klaviyo's Custom Events API include:

- *Creating custom events that can be used to trigger flows (e.g., a Reset Password event that triggers an email with a reset password URL).*
- *Getting Klaviyo events that can be used for data analysis (e.g., retrieving engagement events tracked by native Klaviyo metrics, such as Opened Email and Clicked SMS).*
- *Getting a specific profile’s events to power an activity feed.*
- *Getting related profile and/or metric data for a given event.*

Chord will only send events through to Klaviyo if either `email` or `phone` is present in the event payload. Without this identifying attributes, events are skipped.

**Note: **Attentive's Custom Events API is specifically designed to ingest *user action events*. Considering this, *page view *events **are not** passed through.

| **Chord Tracking Event** | *Destination Event/Action*                          |
| ------------------------ | --------------------------------------------------- |
| **All Track Events**     | *Event name passed as is*                           |
| **Identify**             | *Upsert Profile (to create or update user profile)* |

:::hint{type="danger"}
Before connecting destinations in the Chord CDP, please verify with all Destination owners that all **non-Chord CDP** configured destinations are *disabled.*
**
Running external destinations alongside configured Chord CDP destinations ***can result in duplicate events downstream. ***
:::