Connect Klaviyo
Send the sample journey events to Klaviyo so you can build a sample follow-up flow that stops when the shopper buys, win back lapsed samplers, and treat repeat samplers differently.
Klaviyo's Shopify integration sees orders, but it cannot tell that one order was a sample and that another, three weeks later, was the full-size counterpart. Connecting Klaviyo to Tile & Paint Calculator fills that gap: every step of a sample journey becomes an event you can trigger flows from.
How to connect
- In the app, open Klaviyo in the left sidebar.
- Click Connect Klaviyo. You are sent to Klaviyo to approve access (you need an owner, admin or manager role there). Klaviyo may show an "App has not been reviewed" notice first; click Continue.
- Pick the Klaviyo account to connect if you manage more than one, then click Allow.
- You land back on the page with a green Connected badge.
There are no API keys to copy. The app asks Klaviyo for the minimum it needs: read your account name, create events and update the profiles the events belong to.
Only journeys from after you connect are sent live. Importing history or recalculating writes the past events into Klaviyo as records that never fire flows, so connecting never sends a follow-up for an order from last year.
Events sent to Klaviyo
| Metric | Fires when |
|---|---|
| Sample Order Placed | Any order with a sample in a group, including additional samples on an open journey |
| Sample Journey Started | The first sample order of a new journey |
| Sample Journey Converted | A full-size order arrives; the properties say whether it was inside the nurture window, late, or on the same order as a sample |
| Sample Journey Lapsed | The nurture window passed with no full-size order |
| Sample Journey Cancelled | The only sample order on a journey was cancelled or refunded |
| Sample Conversion Reversed | The full-size order was cancelled or refunded and the journey reopened |
Every event carries the group, the journey number, whether the shopper is a repeat sampler, the sampled items with their full-size counterparts (title, link, image, price), the windows, and the order. Profile properties with the same facts are written on every event, so you can segment on "has an open sample journey" without a flow.
Recipes
The Klaviyo page in the app shows these with the exact filters to click.
A sample follow-up that stops on purchase. Trigger on Sample Journey Started. Add a flow filter: Sample Journey Converted zero times since starting this flow (and Sample Journey Cancelled zero times). Klaviyo re-checks the filter at every step, so the moment the full order arrives the flow ends. Send the care-and-install tips, then the nudge, then the offer.
Repeat samplers. Trigger on Sample Journey Started with a trigger filter on the journey number above 1. Split on prior conversions: someone who bought before and is sampling again is a loyal customer picking a second room; someone sampling for the third time without buying needs a different message.
Win-back. Trigger on Sample Journey Lapsed. This one is promotional, so it only reaches profiles with marketing consent.
What is not synced
The app writes events and the properties on them. It never creates lists, changes subscription status, or syncs your customers on its own; your Klaviyo profile count only grows by the sample buyers Klaviyo did not already know, which are the guest checkouts.
Checking that it works
The Klaviyo page shows the connected account, the recent events and the reason if Klaviyo rejected one. Disconnect from the same page at any time.
Sample allowance
The first few samples in every order free, or a fixed amount off each, applied automatically at checkout. Set once in the app, shown next to every sample button and on the cart page.
Privacy and data
What Tile & Paint Calculator stores, where, what it sends to Klaviyo, and what is deleted when you uninstall or when Shopify sends a data erasure request.