Tolstoy connects to Klaviyo so ecommerce teams can use shopper engagement, product interest, add-to-cart activity, and OnYou virtual try-on activity in Klaviyo segments, flows, and campaigns.

Use this guide to install the integration, understand how to use it, and review the Klaviyo data Tolstoy reads and sends.

What the integration does

After a store connects Klaviyo, Tolstoy can:

Send Tolstoy shopper events into Klaviyo as custom metrics.
Associate events with Klaviyo customer profiles when an email address is available.
Use Klaviyo profile, segment, metric, event, campaign, and account data in Tolstoy workflows.
Create Klaviyo segments for shoppers who have engaged with OnYou, when enabled.
Support follow-up campaigns using product titles, product URLs, product images, and try-on image URLs when available.

Tolstoy only sends shopper events to Klaviyo when an email address is available from the signed-in shopper session, a submitted email form, or another Tolstoy identity flow.

Before you begin

You need a Tolstoy account with access to the store you want to connect.
You need a Klaviyo account where you are allowed to approve app access.
You need access to Tolstoy Platform at https://platform.gotolstoy.com.

Install Klaviyo

Click Install from Tolstoy's Klaviyo app listing, or open https://platform.gotolstoy.com/install/klaviyo.
Sign in to Tolstoy Platform if prompted.
Tolstoy redirects you to Klaviyo's authorization screen.
Sign in to Klaviyo if prompted.
Review the requested Klaviyo permissions and click Allow.
After approval, Klaviyo redirects you back to Tolstoy.

When the connection succeeds, Tolstoy shows Klaviyo as connected. If your Klaviyo organization name is available, Tolstoy displays it next to the connection status.

Tolstoy install flow for Klaviyo.

Klaviyo OAuth permissions screen for TolstoyApp

Klaviyo authorization screen where you approve TolstoyApp permissions.

Tolstoy connector page after Klaviyo is connected.

Use the integration

After Klaviyo is connected, Tolstoy can use Klaviyo data in agent and connector workflows. Example questions include:

Which Klaviyo flows are converting best over the last 30 days?
Show me our largest segments and their recent engagement rates.
Find campaigns with high unsubscribe rates this quarter.

Tolstoy events appear in Klaviyo as custom metrics. You can use them to trigger flows, filter segments, or personalize campaign content.

Data Tolstoy reads from Klaviyo

Tolstoy may read the following Klaviyo data to power the integration:

Account details: used to confirm the connected Klaviyo account and show connection status.
Metrics and events: used to find Tolstoy and Klaviyo activity that can power reporting, segments, and campaigns.
Segments and lists: used to view or create customer audiences for Tolstoy workflows.
Profiles: used to associate Tolstoy events with Klaviyo customer profiles.
Campaigns: used by Tolstoy agent workflows to review or assist with marketing activity.

Data Tolstoy sends to Klaviyo

Tolstoy sends events to Klaviyo using Klaviyo's Events API. Each event is associated with a Klaviyo profile when an email address is available.

Core events

Generated OnYou TryOn: sent when a shopper generates an OnYou try-on from the Tolstoy shopper experience. Use it to trigger a try-on follow-up flow or build an OnYou shoppers segment.
Tolstoy Last Product Viewed: sent when a shopper views a product through the Tolstoy shopper experience. Use it to retarget shoppers based on recent product interest.
Tolstoy Product Added to Cart: sent when a shopper adds a product to cart from a Tolstoy shopper experience. Use it to trigger cart follow-up flows or measure commerce intent from Tolstoy.
OnYou Tryon Completed: sent when a try-on generation completes and Tolstoy has the shopper email. Use it to personalize flows with the completed try-on image.

Optional events

These events appear only when the related Tolstoy feature or workflow is enabled for the store:

OnYou Followup Tryon: sent when Tolstoy generates an automated follow-up try-on for a campaign.
Generated In-Store TryOn: sent when a shopper completes an in-store try-on flow.
Requested TryOn to Email: sent when a shopper requests a try-on to be sent by email.

Event properties

Tolstoy may include these event properties, depending on the event and product data available:

storeDomain: store domain connected to Tolstoy.
productId: product identifier from the store catalog.
productVariantId: variant identifier, when available.
productTitle: product title.
productUrl: product detail page URL.
productImageUrl: product image URL.
tryonImageUrl or tryonUrl: generated try-on image URL, when available.
tryonRunId: Tolstoy try-on generation run identifier, when available.
widgetType or source: Tolstoy source context, when available.
campaignType, isAutomatedCampaign, and originalProductId: automated campaign context, when available.

Profile attributes

Tolstoy may send these profile attributes:

email: shopper email address. Required for the event to be sent.
first_name: shopper first name, when available.
last_name: shopper last name, when available.

Profile properties

Some OnYou and automated campaign workflows may update profile properties, depending on the event:

Latest try-on image, product ID, product title, product URL, and product image URL.
Latest completed try-on timestamp.
Latest automated follow-up try-on image, product details, and generation timestamp.
Klaviyo profile ID used by automated campaign processing, when available.

Klaviyo permissions

Tolstoy requests the Klaviyo permissions needed to read account data, read and write events, read metrics, read lists, read profiles, and read or create segments.

Current OAuth scopes:

accounts:read
campaigns:read
campaigns:write
events:read
events:write
lists:read
metrics:read
profiles:read
segments:read
segments:write

Optional Klaviyo settings in Tolstoy

If Klaviyo is connected, the Klaviyo settings modal may show optional controls for automated try-on campaigns and customer segments.

Enable Automated Try-On Campaigns: allows eligible stores to send weekly try-on campaign activity to Klaviyo.
Customer Segments: allows Tolstoy to create an OnYou Customers segment in Klaviyo for shoppers who generated at least one try-on image.

Tolstoy Klaviyo settings showing automated campaigns and customer segments

Optional Tolstoy Klaviyo settings for automated try-on campaigns and customer segments.

Disconnect Klaviyo

Open Tolstoy Platform.
Go to Settings and open Connectors.
Select Klaviyo.
Click Disconnect.

You can also remove TolstoyApp access from your Klaviyo app or integration settings. Disconnecting stops Tolstoy from sending new Klaviyo events for that store. Existing Klaviyo events, metrics, profile properties, and segments remain in Klaviyo unless you remove them in Klaviyo.

Troubleshooting

Klaviyo does not show Tolstoy events

Confirm that:

Klaviyo is connected in Tolstoy.
The shopper has an email address available.
The shopper completed an event that sends data to Klaviyo, such as adding a product to cart, generating an OnYou try-on, or viewing a product through the Tolstoy shopper experience.
The product exists in the connected product catalog.

The OnYou segment is empty

The segment only includes profiles that have an email address and a Generated OnYou TryOn event. Generate a new try-on with a test shopper email, then allow Klaviyo time to process the profile and segment membership.

OAuth approval failed

Start the connection again from Tolstoy. If the issue persists, confirm the Klaviyo user has permission to approve app access for the account.

Support

For help with the Tolstoy Klaviyo integration, contact Tolstoy support at support@gotolstoy.com.

Tolstoy Klaviyo Integration Guide