Connect Klaviyo
This article shows you how to create a Klaviyo private API key, connect Klaviyo to PlayerMagick, send the emails a gate collects to a Klaviyo list, and start Klaviyo flows from what people watch.
Available on: Pro, Business and Agency plans.
Before you start
- You need a Klaviyo account and a role that can create API keys (owner, admin or manager).
- Only the PlayerMagick account owner or an admin can connect Klaviyo. See Understand team roles.
Klaviyo sometimes renames its menus. If a label below does not match exactly, look for the closest one.
Step 1: Create a private API key in Klaviyo
- Log in to Klaviyo.
- Go to Settings → API keys.
- Click Create Private API Key and name it
PlayerMagick. - Give it full access to Accounts, Events, Lists, Profiles and Subscriptions. PlayerMagick needs nothing else.
- Copy the key (it starts with
pk_).
Step 2: Connect Klaviyo in PlayerMagick
- Go to Settings → Integrations.
- Click Connect an email tool (or Connect next to Klaviyo) and choose Klaviyo.
- Paste the key into Private API key.
- Click Test and connect.
PlayerMagick checks the key with Klaviyo and reads your lists before saving it.
Step 3: Choose a list for a gate
- Open your video, click the Interactions tab and click the email gate.
- Under Send leads to, choose your Klaviyo account and a List.
- Click Save destination.
- Confirmation emails: Klaviyo uses the list's own double opt-in setting. On a list with double opt-in, Klaviyo sends its confirmation email; otherwise the person is subscribed at once.
- Tags: Klaviyo has no tags on people, so a Klaviyo gate has no tags. Use a list, a property or an event instead (below).
- Leads are added by a Klaviyo job: they appear in the list a few seconds later.
Start Klaviyo flows from what people watch
Klaviyo flows can start on an event. In PlayerMagick, add the action Send an event to Klaviyo to an automation:
- In Automations, create an automation, for example "When they watch 50% of the video".
- Under Do, click + Add action and choose Send an event to Klaviyo.
- Keep the suggested name (for example
PlayerMagick: Watched 50%) or type your own. - Save the automation.
- In Klaviyo, create a flow with the trigger Metric and choose the event's name. It appears in Klaviyo after the first event arrives.
Each event carries the video, the funnel step and answer, the share watched and the personal deadline as properties, so your emails can use them. It never carries an email address.
Other actions for Klaviyo: Add to a list, Remove from a list (for people already in Klaviyo) and Update a field (any profile property, for example pm_deadline).
Recognise viewers from your Klaviyo emails
Add this to the end of the links in your Klaviyo emails:
?pm_kl={{ person.KlaviyoID }}
When a subscriber clicks, PlayerMagick knows who they are and your automations can act on them. See Recognise viewers from your emails. Send yourself a test email and use Check a link to make sure it works.
Good to know
- Someone who unsubscribed or is suppressed in Klaviyo is never subscribed again. Leads shows Not added.
- Speed: Klaviyo allows many requests per second; leads usually arrive within seconds.
Error messages
| Message | What to do |
|---|---|
| "Klaviyo did not accept this key. Check that you copied the whole key." | Copy the private key again (it starts with pk_). A public key (site ID) does not work. |
| "This key can't read your lists. Use a key of a user who can manage contacts." | Give the key full access to Lists, Profiles, Subscriptions, Events and Accounts. |
| "Klaviyo didn't answer. Try again in a minute." | Try again in a minute. |
All statuses and fixes: Fix an email tool error.