Finsi for Klaviyo: User Guide

How to install, connect, and run Finsi Email Autopilot inside your Klaviyo account. Covers OAuth setup, the five core workflows, OAuth scopes, data handling, disconnect, troubleshooting, and support.

Finsi for Klaviyo: User Guide

Last Updated: May 25, 2026 App: Finsi Email Autopilot for Klaviyo Audience: Klaviyo Owners, Admins, and marketers at Shopify and DTC brands using Finsi


1. Overview

Finsi is an AI Chief Marketing Officer (AI CMO) platform for $1M–$50M Shopify brands. Finsi's email-marketing agent - internally called ECHO, surfaced in the product as Email Autopilot - runs inside your Klaviyo account and does five jobs a retention marketer would otherwise own:

  1. Build and maintain lifecycle flows based on the gaps in your account.
  2. Plan and draft campaigns on a rolling calendar.
  3. Suggest segments worth emailing this week, with the brief to send.
  4. Report revenue per flow and segment, broken down by cohort and acquisition source.
  5. Clean the dead weight off your sending list before it tanks deliverability.

The rest of Finsi's platform sits outside Klaviyo and is out of scope for this guide.


2. Requirements

To install and use Finsi for Klaviyo you need:

  • A Klaviyo account with Owner or Admin role
  • A Shopify store connected to that Klaviyo account (Email Autopilot requires Shopify order data to attribute revenue and segment by purchase history)
  • An active Finsi account at app.finsi.ai (free trial works for evaluation)

There is no separate Klaviyo plan or pricing tier required from Klaviyo's side. Email Autopilot works on any Klaviyo plan that supports OAuth integrations.


3. Installation

Email Autopilot is installed through the Klaviyo Marketplace.

  1. From the Klaviyo Marketplace, search for Finsi and open the listing.
  2. Click Install on the Finsi listing. Klaviyo prompts you to sign in if you are not already authenticated.
  3. Review the OAuth consent screen. You will see the list of scopes Finsi requests (the full list is in section 6 below). Click Allow.
  4. Klaviyo redirects you to Finsi at app.finsi.ai/onboarding/klaviyo. If you do not yet have a Finsi account, create one with your business email. Existing Finsi customers are auto-matched by Klaviyo account ID.
  5. Email Autopilot pulls your Klaviyo data on first connect. Initial sync takes 5–20 minutes depending on account size. You can use Finsi while the sync runs - features become available as data lands.

If you see an "Insufficient permissions" error during OAuth, your Klaviyo role is not Owner or Admin. Hand the install to someone with the right role; you cannot grant the scopes Finsi needs from a lower-tier role.


4. Connecting Shopify

Email Autopilot's revenue attribution, cohort analytics, and post-purchase flow generation all depend on Shopify order data. Connect Shopify before doing anything else in Email Autopilot.

In the Finsi app:

  1. Open Settings → Integrations.
  2. Click Connect Shopify.
  3. Authorize the Finsi Shopify app on your store. Finsi requests read_orders, read_customers, read_products, and read_checkouts scopes.
  4. Wait for the historical order sync to complete. For a 12-month order history this is typically 10–30 minutes.

Without Shopify connected you can still browse flows and campaigns, but Email Autopilot will show "Awaiting Shopify connection" in any panel that needs order attribution.


5. Using Email Autopilot

The five workflows below are accessed from the Email Autopilot section of the Finsi sidebar.

5.1 Lifecycle Flow Builder

Identifies missing or under-performing flows, drafts them, and pushes them into Klaviyo as drafts you review before activating.

  1. In Finsi, go to Email Autopilot → Flow Autopilot.
  2. Click Run Gap Analysis. Email Autopilot compares your active flows against a benchmark set (welcome, browse abandonment, cart abandonment, post-purchase, replenishment, VIP, win-back). Runs in 30–60 seconds.
  3. Review the ranked gap list. Each item shows estimated revenue impact based on your traffic, AOV, and existing flow performance.
  4. Click Build on any flow to generate the full Klaviyo flow: branching logic, email content drafted in your brand voice, and the suggested trigger.
  5. Click Push to Klaviyo to send it into your account as a draft. Email Autopilot never activates a flow on your behalf - review and turn it on inside Klaviyo.
  6. Use Build All to generate every gap-flagged flow in one operation.

[screenshot: Flow Autopilot dashboard showing gap analysis with ranked missing flows]

[screenshot: Generated flow detail view with branching logic and email drafts before push]

5.2 Campaign Calendar

Plans the next 30–60 days of one-off campaigns and drafts the emails on the dates recommended.

  1. Go to Email Autopilot → Campaign Calendar.
  2. The calendar shows recommended campaigns slotted onto specific dates. Each slot includes angle, target segment, and expected revenue lift.
  3. Click any slot to see the generated email and the rationale (why this audience, why this offer, why now).
  4. Edit copy, swap segments, or move the send date. Changes save back to the calendar.
  5. Click Push to Klaviyo to send the campaign in as a draft. Klaviyo handles scheduling and delivery.

[screenshot: Campaign Calendar month view with recommended campaigns on specific dates]

[screenshot: Single campaign detail showing copy, segment, rationale, and Push to Klaviyo button]

5.3 Segment Suggester

Proposes new segments worth emailing this week based on Shopify order data and Klaviyo events. Useful when your existing segments are too broad or stale.

  1. Go to Email Autopilot → Email Suggestions.
  2. See ranked segment ideas with projected size, recommended message angle, and expected revenue per recipient.
  3. For each suggestion: preview the segment definition in plain English, preview a sample of matching profiles, edit criteria, or push to Klaviyo.
  4. Push to Klaviyo creates the segment using Klaviyo's native definition syntax. Immediately available in campaigns and flows.

[screenshot: Email Suggestions list showing ranked segment ideas with projected size and revenue]

[screenshot: Segment definition preview with sample profiles and Push to Klaviyo button]

5.4 Flow Analytics

Shows what each Klaviyo flow is actually earning, broken down in ways Klaviyo's native reporting does not surface easily.

  1. Go to Email Autopilot → Flow Analytics.
  2. The dashboard lists every active flow with revenue, open rate, click rate, and conversion rate over 30, 60, or 90 days.
  3. Click any flow for per-message performance, new-vs-returning revenue split, and the cohort retention curve for customers who entered the flow.
  4. Health badges flag flows below benchmark for their type. Click Improve for specific recommendations (rewrite a subject line, retime a trigger delay, fix a missing branch).
  5. Recommended changes can be applied back to Klaviyo as a draft message update.

[screenshot: Flow Analytics dashboard with active flows, revenue, and health badges]

[screenshot: Single flow detail with per-message performance and new-vs-returning revenue split]

5.5 List Health and Skipped Recipient cleanup

Monitors your sending list for engagement decay, suspected bots, and unengaged profiles that drag down deliverability. Cleaning these typically restores 10–30 percent of inbox placement for affected sends.

  1. Go to Email Autopilot → List Health.
  2. Click Scan. Email Autopilot reviews open and click history, profile age, double-opt-in status, and Klaviyo's skipped-recipient log.
  3. Review Suspected Bots and Engagement Decay. Each entry shows the reason for flagging.
  4. Confirm bots removes them from your sendable audience. Suppress unengaged moves a profile to suppressed status in Klaviyo.
  5. Both actions write back via the profiles:write scope. Reverse with Unsuppress any time.

[screenshot: List Health overview with engagement decay chart and suspected bots count]

[screenshot: Suppression candidates table with reason codes and bulk suppress action]


6. Permissions and data

OAuth scopes requested

Email Autopilot requests these 16 Klaviyo scopes at install: lists:read, lists:write, profiles:read, profiles:write, campaigns:read, campaigns:write, flows:read, flows:write, templates:read, templates:write, events:read, metrics:read, segments:read, segments:write, subscriptions:read, subscriptions:write.

Write scopes power the workflows above: flows:write + templates:write for pushing flow drafts, segments:write for pushing generated segments, campaigns:write for campaign drafts, profiles:write for List Health suppress/unsuppress actions, subscriptions:write for honoring consent changes captured through Finsi-managed sign-up forms.

What Finsi stores

Encrypted with AWS KMS: your Klaviyo OAuth refresh token, a copy of your flow definitions and campaign metadata, anonymized event aggregations used for analytics, and segment-membership counts. We do not store the content of emails sent to your customers, and we do not store profile-level personal data beyond what is needed for the analytics and recommendations above.

Full details in our Information Security Policy and Sub-processor list.


7. Disconnect and data removal

You can disconnect Email Autopilot from either side of the connection.

From Klaviyo: Go to your Klaviyo account settings, find Finsi under installed integrations, and click Revoke access. The OAuth token is invalidated immediately and Finsi stops being able to read or write to your account.

From Finsi: In the Finsi app, go to Settings → Integrations → Klaviyo, click Disconnect, and confirm. Finsi revokes the OAuth token from its end and stops all sync immediately.

Either path triggers the same data-removal SLA: within 30 days of disconnect, Finsi purges all stored Klaviyo data (flow definitions, campaign metadata, event aggregations, segment counts) from its production database and backups. Aggregated and anonymized data that cannot be linked back to your account may be retained for internal benchmarking.

To request immediate (within 7 days) deletion of all data, email privacy@finsi.ai with the subject "Klaviyo data deletion request" and the Klaviyo account ID.


8. Troubleshooting

Initial sync stuck at 0 percent. Refresh once. If still stuck after 5 minutes, the cause is usually a Klaviyo API rate-limit ceiling on large-profile accounts. Email Autopilot retries with backoff and completes within 1–2 hours.

Pushed flow is missing in Klaviyo. Email Autopilot pushes flows as drafts, not published. Look under Flows → Drafts. If still missing, check the Email Autopilot activity log; most common cause is a name collision with an existing flow.

Revenue numbers do not match Klaviyo's reporting. Finsi attributes via Shopify order data joined to Klaviyo profile IDs. Klaviyo attributes via its own placed-order events. The two methodologies diverge 5–15 percent for most accounts. Neither is wrong; they measure slightly different things.

OAuth disconnected and will not reconnect. Happens when the refresh token expires (after 30 days of inactivity) or a Klaviyo Owner revokes access. Go to Settings → Integrations → Klaviyo → Reconnect and complete the OAuth flow. Existing pushed flows and segments are not affected.

Generated emails do not match brand voice. Open Settings → Brand Voice. With nothing configured, Email Autopilot infers from your existing Klaviyo templates and Shopify storefront. The first 10–20 generations are weakest; the model calibrates as you accept or reject. Paste a reference email or upload a brand-guidelines PDF to speed this up.

Segment counts differ from the Finsi preview. Klaviyo evaluates segments at send time against the live database; Finsi previews against the sync snapshot (5–60 minutes old). Small differences are expected. If the gap is greater than 10 percent, force a resync from Settings → Integrations → Klaviyo → Resync.


9. Support

For questions, integration issues, or feature requests:

  • Email: support@finsi.ai
  • Privacy and data requests: privacy@finsi.ai
  • Help center: help.finsi.ai
  • Response SLA: First response within one business day for support questions; same-day for any issue blocking onboarding or causing data sync errors.

10. Related reading

Stop guessing. Start knowing.

Finsi connects your Shopify, ads, and email data - then tells you exactly what to do next. Free 30-day trial, no credit card.