# 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.

Source: https://onecounter.app/guides/klaviyo/

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](https://onecounter.app/guides/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](https://onecounter.app/guides/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](https://onecounter.app/guides/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.
