Klaviyo Integration

Use Klaviyo with Frevana by creating a private API key with the required scopes.

Prerequisites

Before you start, make sure you have:

• A Klaviyo account

• Access to the target Klaviyo account

• Permission to manage API keys

What Frevana needs

To complete the setup, you will need:

• A Klaviyo private API key

• The correct Klaviyo account selected

• The required scopes enabled on the key

Setup steps

1

Open API key settings

Open Klaviyo API Keys.

2

Create a new private API key

Click Create Private API Key.

Enter a recognizable name, for example:

Frevana Integration

Select Custome Key and Select API Scope(Full Access) :

Campaigns, Segments，Tags，Templates，List，Profiles

Use a dedicated key for Frevana. This makes rotation and access review easier later.

3

Enable the required scopes

Grant the scopes required for your Frevana workflow.

Start with the resources you plan to sync, such as:

• Profiles

• Lists and Segments

• Campaigns or Events

If your setup test fails, edit the key and add the missing scope.

4

Generate and copy the API key

Click Create to generate the key.

Copy the full private API key immediately.

Store it in a secure password manager or secret store.

Treat the API key like a password. Do not share it in chat, email, or screenshots.

5

Save the key as an environment variable

For quick setup, save the key as an environment variable first.

Use the full key exactly as copied from Klaviyo.

macOS / Linux

export KLAVIYO_API_KEY="your_klaviyo_private_api_key"

Windows PowerShell

setx KLAVIYO_API_KEY "your_klaviyo_private_api_key"

Do not include extra spaces or line breaks.

Troubleshooting

401 Unauthorized

Verify that:

• The full API key was copied

• The key is still active

• You are using a private API key, not a public identifier

403 Forbidden

Verify that:

• The required scopes are enabled

• The key belongs to the correct Klaviyo account

• The integration is only calling resources allowed by that key

Cannot find the API key page

Verify that:

• You are signed in to the correct Klaviyo account

• You opened Settings → Account → API Keys

• Your account has permission to manage API keys

Ready to connect

Once the API key is added, Frevana can connect to Klaviyo and continue the integration setup.