Appearance
Klaviyo Integration
Connect your own Klaviyo account and send wishlist activity to it as events, so you can trigger flows, build segments, and run campaigns from what your shoppers save.
Overview
When a customer saves a product to their wishlist - or removes one - BRIX: Wishlist Plus sends that action to your Klaviyo account as a metric (an event). The app also sends an event to each customer who saved a product when that product's price drops, when it comes back in stock, or when it's running low. Once those events start arriving, you can use them in Klaviyo exactly like any other metric: as a flow trigger, as a segment condition, or as data inside an email or SMS template.
The integration uses your Klaviyo account and your private API key. Nothing is sent until you connect a key, and you can pause or disconnect at any time.
Benefits
- Turn saved products into marketing: send a reminder, a discount, or a "still thinking about it?" email based on what a customer wishlisted
- Send price-drop, back-in-stock, and low-stock emails or SMS through your own Klaviyo flows
- Build segments of customers who saved a specific product, collection, or price range
- Use real product data (name, price, image, product link) directly in your Klaviyo templates
- Works in near real time - events are delivered in the background, so wishlist actions on your storefront are never slowed down
Where to Find It
Apps → BRIX: Wishlist Plus → Settings → Integrations tab → Klaviyo → Customize
Before You Start
You need a Klaviyo account and a private API key from it.
- Log in to Klaviyo.
- Go to Settings → API keys (direct link: klaviyo.com/settings/account/api-keys).
- Click Create Private API Key.
- Give it a name you'll recognize later, for example
BRIX Wishlist Plus. - Give the key these access scopes:
| Scope | Access | Why it's needed |
|---|---|---|
| Events | Write | To create the wishlist events in your account |
| Profiles | Write | To attach each event to the right customer profile |
| Accounts | Read | To show your Klaviyo account name on the connection card |
- Copy the key (it starts with
pk_). Klaviyo shows it only once.
The Accounts: Read scope is optional. If it's missing, the key still works and events still send - you'll just see a message saying your account name can't be displayed.
How to Use
Connect Klaviyo
- Open the app and go to Settings → Integrations tab → Klaviyo.
- Paste your private API key into the Private API key field.
- Click Connect Klaviyo.
The app verifies the key against Klaviyo before saving it. If the key is wrong or revoked, you'll see an error and nothing is saved. On success the card shows your Klaviyo account name, and syncing is switched on automatically - you don't need to flip a second switch.
Confirm events are arriving
- As a logged-in test customer on your storefront, save a product to the wishlist.
- In Klaviyo, open that customer's profile (or Analytics → Metrics) and look for Added to Wishlist.
Events usually appear within a few moments. If nothing arrives, see Troubleshooting below.
Build a flow from wishlist activity
- In Klaviyo, go to Flows → Create Flow → Build Your Own.
- Choose Metric as the trigger, and pick Added to Wishlist.
- Add a time delay (a wait of 1-3 days works well for a reminder).
- Add your email or SMS, using the event properties (
ProductName,ImageURL,ProductURL,Price) to show the exact product the customer saved.
Build a price-drop, back-in-stock or low-stock flow
- In Klaviyo, go to Flows → Create Flow → Build Your Own.
- Choose Metric as the trigger, and pick Wishlist Item Price Drop, Wishlist Item Back in Stock, or Wishlist Item Low Stock.
- Add your email or SMS. Send it right away - these events are time-sensitive.
- Use the event properties in your template. For example, use
PreviousPrice,SavingsandDiscountPercentin a price-drop email, orInventoryQuantityin a low-stock email.
These events only appear in Klaviyo after the first one is sent. If you can't pick the metric yet, wait until a saved product's price or stock changes, then build the flow.
Klaviyo's own guide: Getting started with flows.
Events Sent to Klaviyo
| Metric name in Klaviyo | Sent when |
|---|---|
Added to Wishlist | A customer saves a product to their wishlist |
Removed from Wishlist | A customer removes a saved product - either from the wishlist page or by tapping the heart icon again |
Wishlist Item Price Drop | A saved product's price falls by at least 5%, to below the price the customer saw when they saved it |
Wishlist Item Back in Stock | A saved product goes from out of stock to available again |
Wishlist Item Low Stock | A saved product's stock falls to 3 units or fewer |
Each event carries these properties, which you can use in flow filters, segment conditions, and template tags:
| Property | Example / meaning |
|---|---|
ProductID | The Shopify product identifier |
ProductName | The product title |
Price | The product price as a number |
Currency | The currency code, e.g. USD |
ImageURL | The product image, for use in templates |
ProductURL | A direct link back to the product page |
Variant | The specific variant saved, when one applies |
WishlistName | The name of the list it was saved to (relevant with Multiple Wishlists) |
The price-drop, back-in-stock and low-stock events also carry these extra properties:
| Property | Sent with | Meaning |
|---|---|---|
VariantTitle | All three | The variant name, for example Large / Blue. Left out for products with a single variant |
PriceAtAdd | All three | The price when the customer saved the product |
PreviousPrice | Price drop | The price just before the drop |
Savings | Price drop | How much cheaper the product is now than when the customer saved it |
DiscountPercent | Price drop | Savings as a whole-number percentage |
InventoryQuantity | Back in stock, Low stock | Units now in stock |
LowStockThreshold | Low stock | The stock level that counts as low (3) |
Properties with no value are left out of the event rather than sent empty, so your templates won't show blank fields.
How price and stock events work
- One event per customer. When a saved product changes, every logged-in customer who saved it gets their own event, so your flow sends to each of them.
- Variant-aware. If a customer saved a specific variant, they only get events for that variant.
- Price drops must save the customer money. A customer only gets a price-drop event if the new price is lower than the price when they saved the product.
- Thresholds. A price drop must be at least 5%, so small price changes don't trigger emails. Low stock means 3 units or fewer.
- Sent once per change. Low stock is sent when stock first falls to the threshold, not on every later edit while stock stays low. A product that drops in price again, or goes out of stock and comes back again, sends a new event.
- Low stock needs inventory tracking. Products that don't track inventory in Shopify never send a low-stock event.
- Only new changes. The app records a product's price and stock when it's saved to a wishlist, and sends events for changes after that. Turning the integration on doesn't send events for products that are already in stock or already on sale.
- Prices are in your store's currency. If a customer browsed in a different currency,
SavingsandDiscountPercentare based on the product's previous price instead of the price they saw, andPriceAtAddis left out.
Metric names are permanent. Once you build a flow on
Added to Wishlist, that exact name is what your flow listens for. The app will not rename these metrics.
Available Settings
| Setting | Description | Default |
|---|---|---|
| Private API key | The Klaviyo key the app uses to send events. Shown masked once saved; use Replace to swap it | Not set |
| Sync wishlist events | Master on/off switch. Off means nothing is sent, but your key stays saved | On after connecting |
Added to Wishlist | Per-event switch for product saves | On |
Removed from Wishlist | Per-event switch for product removals | On |
Wishlist Item Price Drop | Per-event switch for price drops on saved products | On |
Wishlist Item Back in Stock | Per-event switch for saved products coming back in stock | On |
Wishlist Item Low Stock | Per-event switch for saved products running low | On |
| Test connection | Re-checks your saved key against Klaviyo and updates the "Key verified" timestamp | - |
| Disconnect | Removes the connection and the stored key from the app | - |
Sync health
The Sync health card gives you three at-a-glance checks:
| Row | What it tells you |
|---|---|
| Key verified | When your key was last confirmed working with Klaviyo |
| Last event delivered | When Klaviyo last accepted an event from your store |
| Last sync failed / No errors reported | The most recent delivery error, if there was one, with the time it happened |
Use Test connection any time you want to re-check the key without waiting for a customer action.
Best Practices
- Test with a real logged-in customer account before building flows, so you can see the exact property values your templates will receive.
- Wait 1-3 days before your first reminder email. Sending the instant a product is saved tends to feel intrusive and converts worse than a short delay.
- Filter your flow on
Priceif you want to treat high-value saves differently from low-value ones. - Use
Removed from Wishlistas a flow exit condition, so a customer who removed the item doesn't keep receiving reminders about it. - Don't add a delay to price-drop, back-in-stock or low-stock flows. These are time-sensitive, and the product may sell out or change price again.
- Turn off events you don't build flows for. For example, if you only want back-in-stock emails, switch off price drop and low stock.
- Pause instead of disconnecting if you only want to stop sending temporarily - switch Sync wishlist events off and your key stays saved.
- Rotate keys deliberately. Replacing your key immediately stops events sent with the old one.
Notes
- Logged-in customers only. Events are sent only for customers the app can identify by email. Guest wishlist activity has no email address attached, so there is no Klaviyo profile to record it against and nothing is sent. Guests who later log in will generate events from that point on.
- Delivery is in the background. Wishlist actions on your storefront never wait on Klaviyo. If Klaviyo is slow or unreachable, the shopper's save still succeeds - the event is retried, and any permanent failure is reported on the Sync health card.
- Duplicates are prevented. Each action carries a unique identifier, so a retry (or a shopper double-tapping the heart) won't fire your flow twice.
- Your key is stored encrypted and is never exposed to your storefront theme. The settings page shows only a masked preview of it.
- Disconnecting deletes the stored key. Reconnecting later means pasting a key from Klaviyo again. If you just want to stop sending, use the Sync wishlist events toggle instead.
- Klaviyo handles consent. Price, stock and wishlist events are sent for every logged-in customer who saved the product. Whether they receive your email or SMS depends on their consent in Klaviyo.
- The integration doesn't sync your product catalog into Klaviyo. Product details travel with each event instead.
Troubleshooting
"Connect" fails with an invalid-key error. The key was mistyped, or it was revoked in Klaviyo. Create a fresh private key under Settings → API keys in Klaviyo and paste it again. Make sure you copied the whole key, including the pk_ prefix.
Connected, but my Klaviyo account name isn't shown. The key works but doesn't have the Accounts: Read scope. Events still send normally. To show the name, edit the key's scopes in Klaviyo (or create a new key with that scope) and use Replace to save it.
The card says the connection needs attention / "reconnect". Klaviyo rejected the stored key - it was almost certainly deleted or its scopes were reduced. Create a new private key in Klaviyo, click Replace, and save it. Syncing resumes automatically.
No events are showing up in Klaviyo. Check, in this order:
- Sync wishlist events is switched on.
- The specific event (for example
Added to WishlistorWishlist Item Price Drop) is switched on in the events list. - You tested as a logged-in customer, not as a guest.
- The Sync health card shows no error. If it does, the message there says what Klaviyo rejected.
- Click Test connection to confirm the key is still valid.
I changed a product's price or stock, but no event arrived. Check that:
- A logged-in customer has the product (or that variant) saved.
- For a price drop: the new price is at least 5% lower, and lower than when the customer saved it.
- For low stock: the product tracks inventory, and stock went from above 3 to 3 or fewer.
- For back in stock: the product was out of stock before, and is now available.
Events stopped right after I changed my key. Replacing a key takes effect immediately and the old key stops being used. Confirm the new key has the Events and Profiles write scopes.
My flow fired twice for one customer. Check the flow's own settings in Klaviyo - by default a "Build Your Own" flow can re-trigger for the same profile. The app itself deduplicates repeated sends of the same action.
A customer saved something but got no email. Confirm that customer exists as a profile in Klaviyo and is subscribed/consented for the channel your flow uses. The app creates the event and the profile identity, but it does not grant marketing consent on your behalf.
