Prerequisites

• An active Klaviyo account from which data is to be ingested exists.

• The API key is available to allow Hevo to connect to your Klaviyo account.

• You are assigned the Team Administrator, Team Collaborator, or Pipeline Administrator role in Hevo to create the Pipeline.

Creating the API Key

You require an API key to authenticate Hevo on your Klaviyo account. The API key does not expire and can be reused for all your Pipelines. You can retrieve the key from your Source administrator or create one.

Note: To create API keys, you must have Owner, Admin, or Manager user role on the account.

To create the API key:

1. Log in to your Klaviyo account.

2. Scroll to the bottom of the left navigation pane, click the Profile icon, and then click Settings.

   

3. In the Settings page, Account tab, click API keys.

   

4. In the Private API Keys section, click Create Private API Key.

   

5. On the Create Private API Key page, do the following:

   

   1. In the Private API Key Name field, specify a name for the API key. For example, Klaviyo Connector for Hevo.

   2. In the Select Access Level section, specify one of the following:

      • Read-Only Key: This level provides read-only access for every API scope.

      • Custom Key: This level provides the selected access only for the specified API scopes. If you select this option, you must provide Read Access for the following API scopes:

        • Campaigns

        • Events

        • Flows

        • List

        • Metrics

        • Profiles

        • Segments

        • Templates

   3. Click Create.

   4. On the Private API Key Confirmation page, click the copy icon to copy the key, and save it securely like any other password. Use this key while configuring your Hevo Pipeline.

      

Configuring Klaviyo v2 as a Source

Perform the following steps to configure Klaviyo v2 as the Source in your Pipeline:

1. Click PIPELINES in the Navigation Bar.

2. Click + CREATE PIPELINE in the Pipelines List View.

3. In the Select Source Type page, select Klaviyo v2.

4. In the Configure your Klaviyo v2 Source page, specify the following:

   

   • Pipeline Name: A unique name for your Pipeline, not exceeding 255 characters.

   • Private API Key: The API key that you obtained from your Klaviyo account.

   • Historical Sync Duration: The duration for which you want to ingest the existing data from the Source. Default duration: 3 Months.

5. Click TEST & CONTINUE.

6. Proceed to configuring the data ingestion and setting up the Destination.