One Counter doesn’t send emails itself. It sends events to your Klaviyo (points earned, reward redeemed, wishlist reminder due and more), and your Klaviyo flows turn them into emails. Connecting takes a few minutes; building the flows is up to you, and this guide lists what to build.
1. Create a key in Klaviyo
In Klaviyo, go to Settings → API keys → Create private API key.
The simplest choice is Full Access. If you’d rather give only what One Counter uses, choose a custom key with:
| Access | Why |
|---|---|
| Accounts: read | To check the key. |
| Profiles: write | To keep each customer’s points and tier on their profile, and to recognise shoppers who click your emails. |
| Events: write | To send the events your flows run on. |
| Lists: write and Subscriptions: write | For the Deals-tab email signup. |
| Metrics: read and Flows: read | To see whether your wishlist reminder flow is live (Remind me only shows once it is), and to build the wishlist flows for you. |
| Flows: write and Templates: write | Only if you want One Counter to build the wishlist flows (sharing and reminders) for you. |
| Reviews: read | Only if you reward Klaviyo Reviews. |
Copy the key. It starts with pk_.
2. Hand it to One Counter
- In Shopify admin, open Apps → One Counter: Drive Loyalty → Settings. (Home’s checklist links here too, from Add your Klaviyo key.)
- On the Rewards emails card, paste it into Klaviyo private API key.
- Select Check and hand over.
You should see Key stored, and the heading changes to Sending through your Klaviyo account’s name. If it says the key doesn’t look right, check you copied a private key starting pk_.
One Counter checks the key’s access when you hand it over. A key without what it needs (accounts, events and profiles) is refused, with a note saying what to add. One missing only optional access is accepted, with a note saying what won’t work.
3. Build the flows you want
Events start arriving in Klaviyo (Analytics → Metrics) as they happen. Each one only turns into an email once you build a flow on it:
| Event | Happens when | Suggested email |
|---|---|---|
| Loyalty Points Earned | An order ships and earns points, or a shopper completes a quick way to earn | “You earned N points” |
| Loyalty Threshold Reached | A shopper has enough points for a reward | “You’ve got a reward waiting” |
| Loyalty Points Redeemed | A shopper redeems a reward | Their reward, how to use it |
| Loyalty Points Adjusted | You adjust someone’s points | A note about the change |
| Loyalty Birthday Bonus | A birthday bonus is given | Happy birthday |
| Wishlist Reminder Due | A reminder date a shopper set arrives | The saved product, with a link back. Remind me only shows once this flow is live (set up saved items). |
| Wishlist Item Added | A shopper saves a product | Optional browse-style follow-up |
| Concierge Escalation Requested | A signed-in shopper uses Need a human? | Optional: an auto-reply to the shopper. The event is on the shopper’s profile, so a plain email goes to them, not your team. |
“Need a human?” messages reach your store’s contact email without any flow (set up the shopping assistant), whether or not you build one. A flow on Concierge Escalation Requested is for answering the shopper, and doesn’t replace that email.
Each customer’s profile also gets One Counter properties you can use in emails and segments, such as qb_loyalty_points_balance and qb_loyalty_tier.
What else connecting turns on
- Recognising shoppers from your emails. Shoppers who arrive from a Klaviyo email are recognised, so your Klaviyo signup pop-up stops showing to people who are already customers, and New visitors deals skip them. The Recognise shoppers who click your emails card in Settings shows whether it’s working. It needs Klaviyo’s own app embed switched on in your theme.
- Wishlist sharing. Shoppers can email their saved items to someone (set up saved items).
- The Deals-tab signup. A Join our list card for new visitors that subscribes them to your list. Which list it uses is set up for you. Email support@onecounter.app to set or change it.
Change or remove the key
To change it, paste a new key on the same card and select Check and replace. It takes effect within a minute. Uninstalling One Counter stops it using your key straight away. If you revoke the key in Klaviyo, sending stops, but the card still shows Key stored, so paste a new key there afterwards.
Without Klaviyo
Rewards still work, and points still show in the drawer, and Need a human? messages still reach your contact email. Without Klaviyo there are no reward emails, no wishlist sharing or reminders (Remind me stays hidden), and no Deals-tab signup.
Setting this up with an AI assistant? Give it this guide as plain text, or the list of every guide.