How to Connect a Spin Wheel Popup to Omnisend

TL;DR

Connect a PopupBoost spin wheel to Omnisend in four steps: API key, connection, tags and events. Plus three automations to build on the prize events.

How to Connect a Spin Wheel Popup to Omnisend

A spin wheel signup is worth the most in the first hour, while the shopper still remembers what they won. If that contact sits in a popup app until someone exports a CSV, the moment is gone.

To connect a spin wheel popup to Omnisend, create an Omnisend API key with read and write access to contacts and events, paste it into PopupBoost under Settings, Integrations, Omnisend, and turn on auto-sync. New subscribers who gave marketing consent then arrive in Omnisend with a tag, and every spin sends an event you can use to trigger automations.

In short

  • The setup takes four steps and about five minutes.
  • Only subscribers who gave marketing consent are synced, as Omnisend requires.
  • Two events reach Omnisend: "Spin Wheel Prize Won" and "Spin Wheel Played".
  • The prize won event carries the code and its expiry, so Omnisend can send a reminder before it runs out.

What you need before you start

  • A PopupBoost spin wheel or other game campaign on your Shopify store
  • An Omnisend account with access to its API keys
  • A form that asks for an email or phone number and, for EU shoppers, a consent checkbox

How to connect PopupBoost to Omnisend

Step 1: Create an Omnisend API key

In Omnisend, go to Integrations & API → API keys and create a new key. Give it these permissions:

  • Contacts: Read + Write
  • Events: Read + Write

Copy the key. Omnisend's own guide shows how to generate an API key.

Step 2: Paste it into PopupBoost

Open PopupBoost in your Shopify admin, go to Settings → Integrations, find Omnisend, paste the key and click Connect. PopupBoost checks the key before it enables the integration.

Step 3: Turn on auto-sync and set a tag

Enable Auto-sync new subscribers so every new signup goes to Omnisend on its own. Then set the subscriber tag. The default is popupboost-subscriber. Change it to match your segments, for example spin-wheel-bfcm for a seasonal campaign.

Step 4: Sync the subscribers you already have

Connecting starts an initial sync of your existing eligible subscribers. You can run it again any time with Sync all subscribers. PopupBoost shows the progress and how many contacts were synced.

The full reference, including troubleshooting, is in the help article on the Omnisend integration.

What PopupBoost sends to Omnisend

Contacts

DataSent as
EmailContact field
Phone, when collectedContact field
Subscriber tagTag on the contact

Only subscribers who gave marketing consent and have an email or phone number are synced. Omnisend requires this, so there is no option to sync contacts without consent.

Events

EventWhen it fires
Spin Wheel Prize WonThe shopper plays and wins a prize
Spin Wheel PlayedThe shopper plays and does not win

Event properties can include prize_type, prize_label, prize_value, discount_code, discount_value, discount_scope, expires_at, hours_valid, redirect_url, won_at, campaign_name and prize_tag. Those are what make the automations below possible.

Three automations to build on spin wheel events

1. The code reminder

Trigger: Spin Wheel Prize Won. Wait: until a few hours before expires_at. Condition: no order placed. Message: "Your {{prize_label}} expires tonight. Your code: {{discount_code}}."

Build this one first. A winner who leaves to compare prices may forget the code, and this brings it back.

2. The consolation message

Trigger: Spin Wheel Played (no win). Message: a welcome email with your bestsellers and, if your margins allow, a small first-order offer. A shopper who spun and lost is still a warm lead.

3. Prize-based welcome series

Split your welcome series by prize_type. Free shipping winners get a nudge toward the shipping threshold. Gift winners get a reminder of the gift and the minimum order. Percentage winners get your most popular products.

Common problems and fixes

ProblemCheck
Connection failsThe full key was copied, and it has Contacts and Events read + write
Connected, but no contacts arriveAuto-sync is on, and subscribers ticked marketing consent
Contacts arrive, automation does not startThe automation uses the exact event name, such as "Spin Wheel Prize Won"
Wrong segmentThe subscriber tag in PopupBoost matches your Omnisend segment

Omnisend or Klaviyo?

PopupBoost connects to both, as well as Shopify customers and Mailchimp. If you already use Klaviyo, the setup is similar: read how to sync popup signups with Klaviyo and Shopify Email. Pick the tool you already send email from, since splitting your list across two platforms causes more problems than either tool solves.

Your next step

Connect the integration, then build the code reminder automation first. It takes ten minutes and works on every prize your wheel gives away. If you are still setting up the wheel, start with how to set up a spin wheel popup on Shopify, and pick a design on the templates page.

Frequently asked questions

How do I connect a spin wheel to Omnisend?

Create an Omnisend API key with read and write permissions for contacts and events. In PopupBoost, open Settings, Integrations, Omnisend, paste the key and click Connect. Then turn on Auto-sync new subscribers and set a subscriber tag so the new contacts are easy to find in your Omnisend segments.

Which subscribers are synced to Omnisend?

Only subscribers who gave marketing consent and have an email address or phone number. Omnisend requires consent, so PopupBoost has no option to sync contacts without it. Shoppers who played but did not consent can still use their prize, they just do not join your Omnisend list.

Can Omnisend send the spin wheel discount code?

Yes. The Spin Wheel Prize Won event includes the discount code, prize label and expiry time as event properties. Use them in an Omnisend automation to send the code by email or SMS, or to remind the winner shortly before the code expires.

What happens to subscribers I collected before connecting?

Connecting starts an initial sync of existing subscribers who gave marketing consent, so you do not have to export anything. You can run it again at any time with Sync all subscribers in the Omnisend integration settings, and PopupBoost shows how many contacts were synced.

Article by

PopupBoost Team

We build PopupBoost, the gamified popup app for Shopify. Our posts use anonymized data from the campaigns running on PopupBoost stores, so the advice comes from real results, not guesses.

START YOUR FIRST SPIN WHEEL CAMPAIGN

Join thousands of Shopify merchants using gamified popups to boost conversions.

Shopify
Available on Shopify App Store