fullmetrixDocs

Klaviyo

Create a Klaviyo private API key, connect one or more accounts to Fullmetrix and send your audiences as Klaviyo lists that stay up to date.

Klaviyo is an email and SMS marketing tool. The Klaviyo integration sends your Fullmetrix audiences to Klaviyo and keeps them up to date. An audience is a list of people built from a Fullmetrix segment, for example "customers who have not ordered in six months".

Fullmetrix does not send any email or SMS. You create your campaigns and flows in Klaviyo as usual, targeting the lists Fullmetrix created there.

How your audiences reach Klaviyo

For each audience sent to Klaviyo, Fullmetrix creates a static list named fullmetrix: followed by the audience name, for example fullmetrix: VIP Customers. A static list is a list whose members are added one by one, unlike Klaviyo segments, which are computed from rules.

After that, about every five minutes, Fullmetrix compares the audience with the list. A person who enters the audience is added to the list, a person who no longer matches is removed. Your other lists and other Klaviyo profiles are never changed.

Fullmetrix sends the email, phone, first name, last name and country when they are known. A person with neither email nor phone cannot be sent to Klaviyo.

What you need before you start

Have this ready

Access to your Klaviyo account with the right to create a private API key. If you manage several Klaviyo accounts, sign in first to the account that matches this Fullmetrix organization.

Klaviyo has no one-click sign-in for this integration. You create a private API key, a kind of password reserved for Fullmetrix, and paste it into Fullmetrix.

Create the private API key in Klaviyo

Open the connection window

In the sidebar, click Settings, then the Integrations tab. In the Communication category, click Connect on the Klaviyo card. The Connect Klaviyo window opens.

Open the prefilled creation page

Click the Create the key with the right scopes link. Klaviyo opens in a new tab on the private key creation page, with the required permissions already checked. Scopes are the permissions granted to the key.

PermissionLevelWhat it is for
AccountsReadRead your account name to show it in Fullmetrix
ListsRead and writeCreate the lists and manage their members
ProfilesRead and writeFind and create profiles
SubscriptionsWriteApply the consent status you choose

Create and copy the key

Give the key a name, such as "Fullmetrix", then create it. Klaviyo shows the key only once. Copy it straight away. It starts with pk_.

Treat the key like a password

Never paste it into an email, a screenshot or a shared document. If it has been exposed, delete it in Klaviyo, create a new one and reconnect the account.

Connect Klaviyo

Paste the key

Go back to the Connect Klaviyo window and paste the key into Private API key. The field hides the value.

Confirm

Click Connect. Fullmetrix checks the key with Klaviyo before saving it and fetches the account name. The Klaviyo connected message appears, the window closes and the card shows a green dot, your account name and the Manage button.

Connect another Klaviyo account

Click Manage on the Klaviyo card. The Manage Klaviyo accounts window lists each connected account. Click Connect another account, then paste the other account's private key. The card then shows 2 accounts connected, for example.

If you paste a new key for an account that is already connected, Fullmetrix replaces that account's old key instead of creating a duplicate. This is the right way to change keys.

Send an audience to Klaviyo

Create the audience

In the sidebar, open Audience Sync, then Synchronization. Click Create an audience, give it a name and choose its segment.

Choose Klaviyo

In Platforms, select Klaviyo. The Klaviyo settings block appears. If several accounts are connected, pick the right one in Klaviyo account.

OptionEffect
Not subscribed (default)Adds profiles to the list without subscribing them. Does not change an existing subscriber
SubscribedSubscribes profiles through the list. Klaviyo then applies the single or double opt-in set on that list. Requires valid consent under GDPR
UnsubscribedUnsubscribes profiles from your marketing emails and SMS

This status only applies to profiles Klaviyo creates at that moment. A profile that already existed keeps its status.

Send it

Click Create and push. The page is covered in Audience synchronization.

Check that everything works

In Klaviyo, open the lists and segments page. A list named fullmetrix: followed by your audience name should appear, with its members. For a large audience, wait a few minutes before comparing counts.

Disconnect a Klaviyo account

Pick the account

Click Manage, then Disconnect next to the account concerned. The Disconnect Klaviyo? window shows how many audiences this account powers.

Decide what happens to the lists

  • Keep in Klaviyo erases the key from Fullmetrix but leaves the lists in Klaviyo. If you reconnect the same account later, audience syncing resumes automatically.
  • Delete from Klaviyo deletes the lists Fullmetrix created, removes Klaviyo from those audiences and deletes the connection. The profiles stay in Klaviyo.
  • Cancel closes the window without changing anything.

If you do not plan to reconnect the account, also delete the private key in Klaviyo.

Common problems

If the problem persists, see Connection and access or contact us with the organization name, the Klaviyo account, the audience concerned and the message shown. Never send us your private key.

On this page