One CounterSetup guides

Connect Klaviyo

Connect your Klaviyo so One Counter can send points, rewards, wishlist and "Need a human?" moments to it, recognise shoppers who click your emails, and power the Deals-tab signup.

Draft

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

  1. In Shopify admin, open Apps → One Counter: Drive Loyalty → Settings. (Home’s checklist links here too, from Add your Klaviyo key.)
  2. On the Rewards emails card, paste it into Klaviyo private API key.
  3. 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

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.