Sync a segment to Klaviyo
Connect Klaviyo with a private API key, open an active segment and select Sync on the Klaviyo row of its Sync tab. The first sync creates a Klaviyo list named after the segment. Select Sync again whenever you want that list to match the segment's current members.
Before you start
Section titled “Before you start”Use this guide when you want to email or text the customers in an Audience Segmentation segment from Klaviyo. To build a segment first, follow Build your first audience segment.
Create a private API key in your Klaviyo account settings before you begin. Give it read and write access to lists and profiles. We recommend adding read access to campaigns and metrics too, so the segment’s Engagement tab can show open rate, click rate and average order value once campaigns go out.
- Open the Klaviyo connection. Go to Integrations, select Klaviyo and select Connect. You can also open a segment, select the Sync tab and select Connect on the Klaviyo row. If you work in the full view of the Webscale AI app inside Shopify, use the Sync tab, since Integrations isn’t available there. Its standard view doesn’t include Audience Segmentation.
- On the Klaviyo Connection page, paste your Klaviyo private API key into the API access token field and select Create. The page shows Connector created successfully! and stays open as Update Klaviyo API Key.
- Select the Verify connection icon beside Update. A bar at the top of the page shows Connection verified when the key works. If verification fails, the reason shows next to the icon.
- Go back to Audience > Segments and open the segment you want to sync. The segment must be active.
- Select the Sync tab. In the Audience sync card, select Sync on the Klaviyo row. The button shows Syncing… while the sync runs.
- Open Klaviyo and confirm the list, as described in the next section.
- Select Sync again whenever you want Klaviyo to reflect the segment’s current members.
How a sync updates Klaviyo
Section titled “How a sync updates Klaviyo”The first sync creates a Klaviyo list with the same name as the segment. It imports each member’s email address, phone number, first name and last name.
Each later sync clears that list and imports the segment’s current members again. People who left the segment are removed. If the segment has no members, the sync empties the list. If you deleted the list in Klaviyo, the next sync creates a new one.
Deleting a segment in Webscale AI does not delete its Klaviyo list.
Check that it worked
Section titled “Check that it worked”In Klaviyo, open Lists & segments and find the list with your segment’s name. Compare its profile count with the number of members on the segment’s Members tab in Webscale AI.
If the list is missing or smaller than expected, refresh the page in Klaviyo.
Troubleshooting
Section titled “Troubleshooting”| Problem | Fix |
|---|---|
| Verification fails | Check that you pasted the whole key and that it is a private API key with read and write access to lists and profiles. Create a new key in Klaviyo if needed, paste it and select Update. Then select the Verify connection icon again |
| The segment can’t be synced | Only active segments can sync. Wait for a new segment to finish loading its members, then try again |
| You can’t start a sync | Syncing needs admin access to your Webscale AI account. Ask an account admin to run it |
| A message says the segment is already syncing | A sync is still running. Wait for it to finish, then select Sync again |
| The list doesn’t appear in Klaviyo | Refresh Lists & segments in Klaviyo. If the list still isn’t there, select Sync again |
| New or departed members don’t show in Klaviyo | Select Sync on the segment’s Sync tab |
| The Klaviyo list is empty | Check the segment’s Members tab. A sync of an empty segment empties the list |
| The Engagement tab stays empty | Give the API key read access to campaigns and metrics. The tab fills in once you send campaigns to the list |
Frequently asked questions
- Are people who leave the segment removed from the Klaviyo list?
- Yes. Each sync clears the Klaviyo list and imports the segment's current members, so anyone who left the segment is removed. If the segment is empty, the sync empties the list.
- Which customer details does a sync send to Klaviyo?
- Each member's email address, phone number, first name and last name.
- What happens to the Klaviyo list if I delete the segment?
- The list stays in Klaviyo. Delete it in Klaviyo if you no longer need it.
- How do I switch to a different Klaviyo account?
- Open the Klaviyo connection, select Disconnect and type disconnect to confirm. This removes the stored API key. Then connect again with a key from the other account.