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

Use this guide to install the integration, understand the data Tolstoy sends to Klaviyo, and build Klaviyo campaigns from Tolstoy events.

What the Integration Does

After a store connects Klaviyo, Tolstoy can:

Send shopper product-view and virtual try-on events into Klaviyo.
Update Klaviyo profile properties with the shopper's latest Tolstoy product and try-on details.
Create Klaviyo segments for shoppers who have engaged with OnYou.
Power follow-up campaigns using try-on image URLs, product titles, product URLs, and product images.

Tolstoy only sends events when the shopper has an email address available from the signed-in shopper session, the 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.
A Klaviyo account where you are allowed to approve app access.
Access to Tolstoy Platform at https://platform.gotolstoy.com.

Install Klaviyo

Click Install from Tolstoy's Klaviyo app listing, or open the Tolstoy install entry point directly.
Sign in to Tolstoy Platform if prompted.
Tolstoy redirects you to Klaviyo's authorization screen.
Sign in to Klaviyo if prompted.
Review and approve the requested Klaviyo permissions.
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.

OAuth Install URL

If you install Tolstoy from Klaviyo's app marketplace, use the app install button from the Klaviyo listing. Tolstoy will send you through Tolstoy login if needed, then continue directly to the Klaviyo authorization screen.

The Tolstoy install entry point is https://platform.gotolstoy.com/install/klaviyo.

Use Klaviyo Events in Flows

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

Common flow ideas:

Send a follow-up email after a shopper generates an OnYou try-on.
Remind a shopper about the last product they viewed in Tolstoy.
Build a campaign using the shopper's latest try-on image.
Segment shoppers who have generated at least one OnYou try-on.

Create the OnYou Segment

Tolstoy can create an OnYou Customers segment in Klaviyo.

This segment includes profiles that:

Have an email address.
Have generated at least one Generated OnYou TryOn event.

To create it:

Confirm Klaviyo is connected to Tolstoy.
Open the Tolstoy Klaviyo connection settings.
In Customer Segments, click Create Segment for OnYou Customers.

The segment is created in Klaviyo and updates automatically as eligible shoppers interact with Tolstoy.

Automated Try-On Campaigns

If automated try-on campaigns are enabled for your store, Tolstoy can generate follow-up try-on content and send related events to Klaviyo. These events can be used to create weekly recommendations, retargeting flows, or personalized product campaigns.

To enable or disable automated try-on campaigns:

Confirm Klaviyo is connected to Tolstoy.
Open the Tolstoy Klaviyo connection settings.
Turn Enable Automated Try-On Campaigns on or off.

Data Sent to Klaviyo

Tolstoy sends JSON:API events to Klaviyo. Each event is associated with a Klaviyo profile when an email address is available.

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.
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.
OnYou Followup Tryon: sent when Tolstoy generates an automated follow-up try-on for a campaign. Use it for weekly recommendations or campaign-specific retargeting.
Generated In-Store TryOn: sent when a shopper completes an in-store try-on flow. Use it to follow up after in-store engagement.
Requested TryOn to Email: sent when a shopper requests a try-on to be sent by email. Use it to send the requested image and continue the conversation 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: generated try-on image URL, when available.
tryonUrl: generated try-on image URL used by automated campaign events.
tryonRunId: Tolstoy try-on generation run identifier, when available.
campaignType: campaign type for automated events, such as weekly_recommendations.
isAutomatedCampaign: indicates whether the event came from an automated campaign.
originalProductId: source product for an automated follow-up recommendation.

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

Tolstoy may update these profile properties:

lastTryonImageUrl: latest generated try-on image URL.
lastTryonProductId: product ID for the latest try-on.
lastTryonProductTitle: product title for the latest try-on.
lastTryonProductUrl: product URL for the latest try-on.
lastTryonProductImageUrl: product image URL for the latest try-on.
lastTryonCompletedAt: timestamp for the latest completed try-on.
lastInStoreTryonImageUrl: latest in-store try-on image URL.
lastInStoreTryonProductId: product ID for the latest in-store try-on.
lastInStoreTryonProductTitle: product title for the latest in-store try-on.
lastInStoreTryonProductUrl: product URL for the latest in-store try-on.
lastInStoreTryonProductImageUrl: product image URL for the latest in-store try-on.
lastViewedProductId: latest Tolstoy-viewed product ID.
lastViewedProductTitle: latest Tolstoy-viewed product title.
lastViewedProductUrl: latest Tolstoy-viewed product URL.
lastViewedProductImageUrl: latest Tolstoy-viewed product image URL.
lastFollowupTryonImageUrl: latest automated follow-up try-on image URL.
lastFollowupTryonProductId: product ID for the latest automated follow-up try-on.
lastFollowupTryonProductTitle: product title for the latest automated follow-up try-on.
lastFollowupTryonProductUrl: product URL for the latest automated follow-up try-on.
lastFollowupTryonProductImageUrl: product image URL for the latest automated follow-up try-on.
lastFollowupTryonGeneratedAt: timestamp for the latest automated follow-up try-on.
klaviyoProfileId: 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

Disconnect Klaviyo

To disconnect:

Open the Tolstoy Klaviyo connection settings.
Disconnect the Klaviyo integration.

Disconnecting stops Tolstoy from sending new Klaviyo events for that store. Existing 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 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