Features

Connecting Klaviyo Reviews to Eevy AI

6 min read

If you collect reviews in Klaviyo today, you do not need to migrate or export anything to start using Eevy AI. The Klaviyo Reviews integration imports your existing review history once, then keeps new reviews in sync automatically every night. The reviews show up in Eevy with the right product, star rating, customer name, photos, and verification status — exactly as if they had been collected in Eevy directly.

If your store is part of a Shop Sync group with other regional stores, Klaviyo-imported reviews are also automatically copied and translated into the sibling stores using the same translation pipeline that handles CSV uploads. So a review imported from your US Klaviyo account will appear (translated) on your DE and FR stores within minutes.

This guide walks through the entire setup, from creating the API key in Klaviyo to verifying the backfill completed.

Before You Start

You need two things: an active Klaviyo account that already has reviews, and an Eevy AI experiment that is set to Live. Eevy needs a live experiment to attach the imported reviews to — if you have not created one yet, follow the Getting Started guide first. The integration uses a private Klaviyo API key with the reviews:read scope. We never ask for your Klaviyo password, and the key is encrypted at rest using a per-deployment secret. You can disconnect at any time and the imported reviews remain in Eevy.

Step 1 — Create a Private API Key in Klaviyo

Log into Klaviyo and go to Account → Settings → API Keys → Create Private API Key. Give the key a memorable name (e.g. "Eevy AI integration"), then under Scopes choose "Custom Key" and grant it reviews:read. Do not enable any other scopes — the integration only reads reviews. Click "Create" and copy the key immediately. Klaviyo only shows the full key once; if you lose it you have to make a new one. The key starts with pk_ and is roughly 40 characters long.

Step 2 — Paste the Key into Eevy

In the Eevy AI dashboard go to Settings → Integrations and find the Klaviyo Reviews card. Paste the private key into the input field and click Connect. Eevy validates the key against Klaviyo immediately — if Klaviyo rejects it (for example, the scope is wrong), you see "Klaviyo rejected the API key" right away and nothing is saved. On a successful validation, the key is encrypted, stored, and the integration flips to Backfilling…

Step 3 — Watch the Backfill

The Klaviyo card now shows a live progress line: "X saved · Y skipped · Z seen so far". Saved is the number of reviews that successfully imported. Skipped is reviews whose Klaviyo product does not match any product currently in your Shopify store — usually deleted or archived products. Seen is the running total Klaviyo has handed us. The backfill processes one page (~100 reviews) at a time and respects Klaviyo's rate limit of 150 requests/minute, so for a typical store with a few thousand reviews it finishes in under a minute. Larger stores (50k+ reviews) may take a few minutes; the page polls every five seconds so you see counts climb in real time. If the backfill exceeds its 25-minute budget for any single run, Eevy preserves the cursor and resumes automatically — no manual intervention.

Step 4 — Verify the Import

When the backfill completes, the integration card flips to Connected with a green pill and shows "Last synced <timestamp>". Open Reviews in the Eevy dashboard and confirm a few things: imported reviews show the correct product handle, star rating, and customer name; photos and videos render correctly (Klaviyo CDN URLs are preserved); reviews you marked "published" or "featured" in Klaviyo are active in Eevy, and "pending" / "rejected" ones are inactive. If you spot reviews missing a product handle, those are the skipped ones from the previous step — typically reviews on products that no longer exist in your Shopify catalog.

Step 5 — Ongoing Sync

Once the backfill is done, Eevy runs an incremental sync against Klaviyo every night at 02:00 UTC. The sync only fetches reviews created since the last successful run, so it is fast and idempotent. New reviews collected in Klaviyo during the day appear in Eevy the following morning. If you need to force a sync sooner — for example, after responding to a Klaviyo customer support thread that created reviews — click Resync now on the Klaviyo card. Resync queues an immediate run (within 5 seconds) and falls back gracefully if there are no new reviews to fetch.

Multi-Store Sync Groups

If your Klaviyo-connected store is part of an Eevy Shop Sync group (for example, a US store synced with DE and FR stores), the imported reviews are automatically copied and translated into the sibling stores. Eevy uses the same translation pipeline that handles CSV uploads and admin review-add, so brand names, placeholders, and numeric values are preserved correctly. When source language equals target language (e.g. US English → UK English), the translation step short-circuits with zero cost. If the translation service is temporarily unavailable, the Klaviyo backfill itself is unaffected — sibling-store copies are best-effort and retry on the next sync. You do not need to connect Klaviyo separately to each regional store. One connection on the source store is enough.

Disconnecting

Click Disconnect on the Klaviyo card to stop syncing. The encrypted API key is zeroed, the connection is marked disconnected, and Eevy stops fetching new reviews from Klaviyo immediately. Imported reviews stay in Eevy untouched — disconnect is non-destructive. If you reconnect later (with the same or a new key), Eevy starts a fresh backfill and uses content-hash deduplication so existing reviews are not duplicated.

Troubleshooting

If the integration shows Error with "Klaviyo API key invalid — please reconnect", the key was revoked or its scopes changed in Klaviyo. Create a new private key with reviews:read and reconnect. If you see "No live experiment found", create or activate an experiment first, then click Resync. If the backfill stays at "Starting…" for more than a couple of minutes, the integration is waiting for the next sync window — try Disconnect → Connect to fire a fresh trigger. For anything else, the eevy-cron logs (visible to support) carry the full error from Klaviyo.

Wrapping Up

Connecting Klaviyo to Eevy is a one-time, two-minute setup: create a private API key with reviews:read, paste it into the Integrations page, and watch the backfill complete. From that point on, Klaviyo reviews flow into Eevy automatically every night, get content-hash-deduplicated, and — if your store is in a Shop Sync group — fan out to your sibling stores translated. No CSV exports, no scheduled imports, no per-store reconfiguration.

Free — 30 seconds