Getting Connected to Klaviyo

Setup the Zoey Klaviyo Integration

Open your Zoey Admin and click on the puzzle-piece icon for Integrations.

In that list you'll find the Klaviyo Integration. Click on Manage Connection to open the integration's settings.

Click on Connect to Klaviyo and then log into your Klaviyo account and allow the integration permissions to get connected.

🚧

Pre-existing Subscribers in Klaviyo must be brought into Zoey before new Profiles can be synced to Klaviyo!

Klaviyo Integration Settings

Set Is Enabled to Yes and the integration will have officially connected your Zoey store to Klaviyo for marketing and analytics.

In the Klaviyo Integration settings each function can be enabled. Here you choose which tracking events and catalog data is sent to Klaviyo.

👍

Set everything to Yes to get the most out of our Zoey Klaviyo Integration!

• Enable Admin Tracking on Store
  If set to Yes, when a store admin logs into a Customer's account their events will also be sent to Klaviyo.

What's Sent to Klaviyo?

The integration sends the following events and data to Klaviyo:

Events

• “Active on Site” event is triggered when an identified profile actively browses your site.

• “Viewed Product” event is triggered when a customer views a product's page, but has not added it to their cart.

• “Added to Cart” event is triggered when a customer adds a product to their cart.

• “Started Checkout” event is triggered when a customer has begun checking out.

• “Placed Order” event is triggered when an order has been placed. This includes details about the order, its items, and the customer.

• “Ordered Product” event is triggered when the product is ordered.

In the image below Zoey store events are logged in Klaviyo! Expand the event to see its details.

Customers

Klaviyo creates what it calls Profiles the first time we send any data to Klaviyo.

That happens two ways:

• Event tracking:
  If a customer is logged in and does not block tracking, Klaviyo will create/update a Profile as soon as they start browsing the site. If the customer is a guest or has tracking blocked, the Profile is created when they reach checkout and enter their email address.
• Newsletter subscribers: All subscribers to your newsletter are synced daily, and their Profile is created or updated when the customer subscribes, or unsubscribes from the the Zoey Newsletter.

Zoey sends just the customer's email address to Klaviyo. Klaviyo has the ability to collect additional data on its own, such as First Name, Last Name, Location etc. Such is out of Zoey's control at this time.

Products , Variants, and Categories

The following will also be sent daily from Zoey to Klaviyo through their API:

• New Categories, Category updates and Category deletion

• New Products, Product updates and Product deletion

• New Variants, Variant updates and Variant deletion

Audit Log and Troubleshooting

On the Zoey Klaviyo Integration page you'll find the Audit Log which records all of the syncs to Klaviyo.

Check the Audit Log for any errors and to see what was synced and when!

Sync Schedules

Schedules are currently set to:

• Every 10 minutes for Events
• Daily at 12am UTC for Subscribers
• Daily at 2am UTC for Catalog Categories
• Daily at 3am UTC for Catalog Products
• Daily at 4am UTC for Catalog Variants

Troubleshooting Data Sync

The sync schedule is currently set to:

• Every 10 minutes for new payloads
• Every 10 hours for retry payloads

If a new payload fails to sync for any reason, it’s set to retry in the next cycle. If it fails in the retry cycle, it’s marked as failed and recorded in the database for analysis.

Zoey Klaviyo Integration FAQs

Can we sync data from the past to get more into Klaviyo?

Events triggered before the integration was connected cannot be sent to Klaviyo.

Subscribers from all-time will be sent in the daily sync and there will be an error if their Subscribed At date is earlier than the Consented At date we're sending.

Subscribers not Syncing to Klaviyo

To view the Subscriber Sync logs and check for errors open the Klaviyo Integration and then scroll down to the Audit Log.

Click to open any of the Subscribers sync logs.

Backdated consent date is after current subscription date error

Invalid input.: backdated consent date [date+time] is after current subscription date [date+time]

Why is this happening?

Zoey is sending a consent date that conflicts with the subscriber’s existing subscription timeline in Klaviyo. This typically happens with existing subscribers, where consent data cannot be updated via the integration unless a valid historical timestamp is provided.

To resolve the error and sync Subscribers successfully:

1. Open the Klaviyo integration in Zoey, and set Enable Historical Subscribers Sync to No.
2. Update the opt-in settings by logging into Klaviyo and opening the Settings in the bottom right corner, then go to API Keys and set Default opt-in to "Single opt-in".

📘

Subscribers sent into Klaviyo will require a double-opt in via email unless default opt-in settings are set to single opt-in.

Why does this work?

Disabling the historical sync prevents Zoey from sending existing subscribers with conflicting consent dates, which Klaviyo rejects.

When subscribers are sent to Klaviyo, they may be subject to double opt-in and receive a confirmation email. Switching to single opt-in ensures they can be added without requiring additional confirmation.