Skip to main content

How to Set Up the Klaviyo Integration for Marketing Events and Subscribers for Storefronts

Updated over 2 weeks ago

Connecting Klaviyo to your Zest storefront lets you capture key gifting moments — like when a corporate gifter places an order or a recipient accepts a gift — as events in Klaviyo.

You can use these events to trigger marketing flows, grow your subscriber list, acquire new customers, and re-engage shoppers who browsed your storefront but didn't complete a gift. Zest handles all transactional emails for storefronts automatically, so this integration is focused entirely on marketing and list management.

Before you begin, make sure you have:

  • Admin access to your Klaviyo account to generate a private API key.

  • Admin access to your Zest account at gifts.zest.co/partners.

  • (Optional) Your Klaviyo marketing subscriber list ID, if you want Zest to subscribe users who opt into marketing.

How to Set Up the Klaviyo Integration

Step 1: Generate a Klaviyo API Key

  1. Log in to your Klaviyo account.

  2. Navigate to Account > Settings > API Keys.

  3. Click Create Private API Key.

  4. Name the key something identifiable, such as "Zest Storefronts."

  5. Set the following permissions to Read/Write: Events, Profiles, Lists, and Subscriptions.

  6. Click Create and copy the key before closing the window.

Use a full-access private key — not a read-only or public key. The key must begin with pk_. Read-only keys will cause a save error when connecting to Zest.

Step 2: Find Your Subscriber List ID (Optional)

If you want Zest to automatically subscribe users who opt into marketing, you'll need a list ID.

  1. In Klaviyo, go to Lists & Segments.

  2. Click the marketing list you want Zest to add subscribers to.

  3. Click the Settings tab.

  4. Copy the List ID shown on that page. It should be exactly 6 characters long.

Step 3: Connect Klaviyo to Your Zest Storefront

  1. Log in to the Zest Partners Portal at gifts.zest.co/partners.

  2. Navigate to Settings > Integrations.

  3. In the Klaviyo integration card, paste your private API key into the Private key field.

  4. If you have a subscriber list ID, paste it into the Marketing subscriber list field.

  5. Click Save.

When you save, Zest will automatically send two test events to Klaviyo to verify the connection — a Placed Gift Order and an Accepted Gift. You can confirm events are reaching Klaviyo by going to Analytics > Metrics in Klaviyo and searching for "Zest."

Zest will also push two test users into your Klaviyo account so you can experiment with flows:

If the API key field appears to clear after saving but you see a green success banner, the integration is working — the key is stored securely and is not displayed after saving.

Understanding Zest Storefront Events in Klaviyo

Zest sends three marketing events from Storefronts. All events use the "Zest Platform -" prefix in title case.

Zest Platform - Placed Gift Order

Fires when a gifter completes an order through your Storefront. Use this to trigger a post-purchase marketing flow or update a customer profile.

Event attributes:

  • Number of Gifts

  • Digital Card Description

  • Zest Gift Order Number

  • Zest Gift Order ID

  • Zest Storefront

  • Zest Concierge Project

  • Selected Products

  • Value (order total, sent as the event's monetary value)

Zest Platform - Accepted Gift

Fires when a gift recipient accepts their gift. This is a strong signal of a new potential customer who has already had a positive brand experience.

Event attributes:

  • Zest Gift Order Number

  • Zest Gift Order ID

  • Zest Gift Invite Number

  • Zest Gift Invite ID

  • From

  • Accepted Products

Zest Platform - Active Lead

Fires when someone starts a gift order on your storefront but does not complete it — similar to an abandoned cart event. This event runs on a daily schedule rather than in real time, so it captures leads from the previous day.

Event attributes:

This event includes the lead's email on their Klaviyo profile but does not include additional custom properties.

To explore the data payload attached to any event, go to Klaviyo > Analytics > Metrics, search "Zest," click into an event, and select a recent activity record to see all available properties.

Building Flows From Zest Storefront Events

Klaviyo flows for storefronts are optional and fully in your control. A few recommended starting points:

  • Use Zest Platform - Placed Gift Order to add gifters to a VIP or loyalty segment.

  • Use Zest Platform - Accepted Gift to welcome new recipients and introduce them to your brand with a first-purchase offer.

  • Use Zest Platform - Active Lead to trigger a short re-engagement sequence for shoppers who didn't complete their order.

Keep flows simple — one trigger event and one or two emails is typically enough to start. Because Zest handles all transactional gifting emails on the corporate side, you don't need to build flows for order confirmations, gift delivery notifications, or shipping updates.

Troubleshooting Common Issues

No events appearing in Klaviyo.

Confirm your API key starts with pk_ and has full read/write permissions for Events, Profiles, Lists, and Subscriptions. Read-only keys won't pass events. You can re-save your integration in Settings > Integrations to trigger fresh test events.

Flows aren't triggering.

Make sure each flow is set to Live rather than Draft or Manual. Only live flows will fire when an event is received.

Events going to the wrong Klaviyo account.

If your brand has multiple Klaviyo accounts, confirm the API key you entered in Zest belongs to the correct one.

Did this answer your question?