← Back to SuperPops
Integration guide

How to connect SuperPops with Klaviyo

Sync your SuperPops subscribers and game outcomes to Klaviyo in one click. This guide walks through setup, what data syncs, and how to build a winner welcome flow that auto-includes the discount code.

2 min setup~10 min for the welcome flow

Prerequisites

  • A Shopify store with SuperPops installed (App Store)
  • A Klaviyo account on any plan

What the integration does

Once connected, SuperPops automatically syncs to Klaviyo:

Profiles

Every shopper who submits their email through a SuperPops game becomes a Klaviyo profile in real time.

Events

Each game play fires custom events: subscriber_captured, game_won, game_lost.

Bulk backfill

One-click push of all existing SuperPops subscribers to Klaviyo as profiles.

You can use these to power Klaviyo flows like winner welcome emails (with the actual code dropped in), almost-played re-engagement campaigns, and game-type-specific segments.

1Connect Klaviyo

  1. In your Shopify admin, open SuperPops.
  2. In the SuperPops sidebar, click Integrations.
  3. Find the Klaviyo card and click Connect Klaviyo.

Heads up

Klaviyo will show a yellow “This app has not been reviewed” warning during authorization. That’s standard for any new integration that hasn’t finished Klaviyo’s review process — it doesn’t mean the integration is unsafe. The authorization screen lists exactly which scopes SuperPops requests; review them and click Allow to continue.

After clicking Allow, you’ll be redirected back to the SuperPops Integrations page. The Klaviyo card now shows a green Connected badge with your Klaviyo company name.

Scopes SuperPops requests

accounts:read

Display your Klaviyo company name in the SuperPops admin.

events:write

Send game and subscriber events to your Klaviyo timeline.

lists:read, lists:write, profiles:read, profiles:write

Required by Klaviyo's bulk-import endpoint for the "Push existing subscribers" feature.

2(Optional) Backfill existing subscribers

If you already have subscribers in SuperPops who haven’t yet been synced to Klaviyo:

  1. On the Integrations page, in the Klaviyo card, click Push N subscribers (where N is your current subscriber count).
  2. SuperPops queues the export in pages of up to 10,000 contacts and pushes them via Klaviyo’s bulk-import endpoint.
  3. A progress card appears with live status. The page refreshes automatically every few seconds.
  4. When the badge changes to Complete, all subscribers have been pushed.
A typical 5,000-subscriber backfill completes in under a minute. Larger lists may take 5–10 minutes; the page polls automatically — no need to refresh.

3Build a winner welcome flow in Klaviyo

This is where the magic happens. The game_won event includes the discount code, so you can drop it directly into a follow-up email.

  1. In Klaviyo, go to Flows → Create Flow → Build your own.
  2. Set the trigger to Metric → game_won.
  3. Add an Email step.
  4. In the email body, use merge tags to insert dynamic content. The available tags:
Merge tagDescription
{{ event.discount_code }}The unique discount code.
{{ event.game_title }}Name of the game they played.
{{ event.discount_value }}Numeric value, e.g. 20.
{{ event.discount_type }}Type, e.g. percentage.
{{ event.reward_title }}Formatted reward, e.g. "20% off".

Example email body

Congrats {{ first_name|default:"there" }}!

You won {{ event.reward_title }} on our {{ event.game_title }} game.

Use this code at checkout — it's yours alone, single-use, and never expires:

{{ event.discount_code }}

[Shop now]

Save and turn on the flow. That’s it — every winning play now triggers a personalized welcome email with the actual discount code, no manual copy-paste.

Available events reference

subscriber_captured

Fires when: Shopper submits their email

emailcustomer_namegame_titlegame_type
game_won

Fires when: Shopper wins a reward

emailcustomer_namegame_titlegame_typediscount_codediscount_typediscount_valuereward_titlecurrency_symbol
game_lost

Fires when: Shopper plays but doesn't win

emailcustomer_namegame_titlegame_type

All events appear on the contact’s Klaviyo profile timeline and are available as flow triggers, segment filters, and analytics dimensions.

Disconnect

To disconnect Klaviyo from SuperPops:

  1. Go to SuperPops → Integrations.
  2. In the Klaviyo card, click Disconnect.

This revokes the OAuth token both inside SuperPops and on Klaviyo’s side. Pending events that haven’t yet been delivered are dropped. Existing Klaviyo profiles and historical events stay in your Klaviyo account — the disconnect only stops new events from being sent.

Troubleshooting

“Reconnect required” badge appears

Your Klaviyo OAuth token has been revoked or expired. Click Reconnect Klaviyo to re-authorize. Your existing Klaviyo profiles and events are unaffected.

Backfill seems stuck

Backfills are processed asynchronously by Klaviyo. The progress card polls every few seconds. For very large lists (50,000+ subscribers), give it 10–15 minutes. If the badge changes to Finished with errors, the first error message is displayed — most often this is a single malformed email address that Klaviyo rejected.

A new game play isn’t appearing in Klaviyo

Events flow through SuperPops’s reliable outbox with retries. If an event hasn’t appeared after ~30 seconds, check:

  1. The Klaviyo card status badge — if it shows Reconnect required, fix that first.
  2. The shopper’s email — Klaviyo rejects malformed emails.
  3. Klaviyo’s API status — rare, but transient outages do happen. Events automatically retry over a 7-day window.

If issues persist beyond a few minutes, contact us at contact@webmakers.studio.

Need help?

Email us or use the floating support button inside SuperPops. We typically respond within a business day.

contact@webmakers.studio