Klaviyo Integration
Setup
Step 1: Get your Klaviyo Private API Key
- Log in to klaviyo.com and go to your account.
- Navigate to Settings → Account → API Keys.
- Click Create Private API Key. Give it a name like Stashlist and set access to Full Access (or at minimum, Events — Read/Write).
- Copy the key. It starts with
pk_.
Keep your private key secure. Never share it publicly or add it to frontend code. Stashlist stores it encrypted and only uses it server-side.
Step 2: Connect in Stashlist
- In your Shopify admin, open Stashlist → Integrations.
- Paste your Private API Key into the Klaviyo card and click Connect.
- The card will show Connected and events will start flowing immediately.
Events reference
Stashlist fires these events to your Klaviyo account. Each event includes the customer's profile (email, name) and the product details.
Event name When it fires
Added to Wishlist A customer saves a product by clicking the heart icon Removed from Wishlist A customer removes a product from their wishlist Viewed Wishlist A logged-in customer with a non-empty wishlist loads the wishlist page Price Drop A wishlisted product's price drops by the configured threshold (%) or more Back in Stock An out-of-stock wishlisted product becomes available again Low in Stock Inventory for a wishlisted product drops below the configured threshold Event properties
Every event includes these properties you can use in your Klaviyo flow templates:
Property Description
ProductId Shopify product ID VariantId Shopify variant ID of the saved item ProductTitle Product name VariantTitle Variant name (e.g. "Blue / Large") Price Price at time of save (as a string, e.g. "89.00") ImageUrl Product image URL for use in email templates ProductUrl Full URL to the product page Notification thresholds
Price Drop, Back in Stock, and Low in Stock events are fired by a background job that checks your wishlisted products on a schedule. You can configure the thresholds in Stashlist → Integrations → Klaviyo → Notification Thresholds.
- Price drop threshold — the minimum percentage drop required to fire a Price Drop event (default: 10%)
- Low in stock threshold — inventory must fall below this number of units to fire a Low in Stock event (default: 5 units)
- Back in stock — fires when a product that was out of stock becomes available. Toggle on/off.
Building flows in Klaviyo
Once events are flowing, you can use them as triggers in Klaviyo flows:
- Go to Flows → Create Flow → Build Your Own
- Set the trigger to Metric and choose the Stashlist event (e.g. Added to Wishlist)
- Build your flow using the event properties above to personalize content
Recommended flows: A 2-email "Price Drop Alert" flow triggered by the Price Drop event, and a "Back in Stock" single email triggered by the Back in Stock event, both showing the product image and a direct Add to Cart link, consistently drive high conversion rates for wishlist marketing.
Segments: Use the Added to Wishlist metric to build a segment of all customers who have saved at least one product. This is a high-intent audience for campaigns.