# Klaviyo setup for PopMCP

You end up with one Klaviyo private API key (it starts with pk_) that you paste into PopMCP's "Private API key" field.

- Auth: API credentials
- Setup time: 3 min
- API base URL: https://a.klaviyo.com/api
- Credentials screen: https://www.klaviyo.com/settings/account/api-keys
- Provider docs: https://developers.klaviyo.com/en/reference/api_overview

## Before you begin

- A Klaviyo account on any plan, including free
- The Owner or Admin role. Klaviyo restricts creating, cloning and deleting private keys to those two roles
- A password manager or vault to paste the key into. Klaviyo never shows it again after creation

## Get your credentials

### 1. Open the API keys page in Klaviyo settings

Click your account name in the bottom-left corner and choose Settings. Open API keys in the settings menu.

Screen: https://www.klaviyo.com/settings/account/api-keys

### 2. Create a private API key

Click Create Private API Key and give it a name you will recognise later, such as `PopMCP`. Select Full Access and click Create.

Screen: https://www.klaviyo.com/settings/account/api-keys

### 3. Copy the key before you close the dialog

Click the copy icon next to the key and paste it straight into your password manager. Click Done to close the dialog.

### 4. Paste the key into PopMCP

Open the Klaviyo connector in PopMCP, paste the key into Private API key, and save.

## Fields PopMCP asks for

- Private API key (apiKey) [required]: Klaviyo → Settings → API keys → Create a private key. Stored encrypted; never displayed after saving.

## Verify

The Klaviyo connector in PopMCP flips to Connected and the tool list loads. Asking for your Klaviyo lists or metrics returns real names from your account.

## Troubleshooting

### 401 Unauthorized on every call

Cause: You pasted the public Site ID, a short six-character string, instead of a private key. Or the key was deleted in Klaviyo.

Fix: Private keys start with pk_ and are long. Create a fresh private key on the API keys page and paste that.

### 403 Forbidden on some tools only

Cause: The key was created with Read-only or Custom Access and is missing the scope that tool needs.

Fix: Klaviyo cannot edit scopes after creation. Delete the key and create a new one with Full Access, or with the specific scopes added.

### You closed the dialog without copying the key

Cause: Klaviyo displays a private key exactly once.

Fix: Delete that key from the API keys page and create a replacement, or use the three-dot menu and Clone to mint a new key with the same name and scopes.

### The API keys page is not visible, or Create Private API Key is greyed out

Cause: Only Owner and Admin users can create, clone or delete a private API key.

Fix: Ask an Owner or Admin to create the key, or to raise your role under Settings, Users.

### The key works but nothing rotates it

Cause: Klaviyo does not expire private keys or email replacements on a schedule.

Fix: Rotate on your own cadence. Clone the key, paste the new value into PopMCP, then delete the old key.

---

Source: https://www.docs.popmcp.com/docs/integrations/klaviyo/