---
title: "Integrating Skio Loyalty Events in Klaviyo"
slug: "integrating-skio-loyalty-events-in-klaviyo"
updated: 2026-04-08T15:25:00Z
published: 2026-04-08T15:25:00Z
canonical: "help.skio.com/integrating-skio-loyalty-events-in-klaviyo"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.skio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrating Skio Loyalty Events in Klaviyo

> [!WARNING]
> This feature is part of [Skio’s Loyalty Program](https://skio.us.document360.io/shared/4f7bc0e3-b403-4dc3-a223-83258f33a22c). To add this feature to your store, reach out to our sales team at [sales@skio.com](mailto:sales@skio.com).

## Loyalty event metrics sent to Klaviyo

Skio integrates with [Klaviyo](https://www.klaviyo.com/) to send real-time loyalty event data, enabling merchants to create targeted email and SMS campaigns based on customer actions. Below is a breakdown of each event, including what triggers it, what data it includes, and how you can use it in your marketing automation.

Each event Skio sends to Klaviyo includes specific data fields that can be used for **personalization and segmentation**.

**See all available event metrics**

### Core Subscription Lifecycle

| Event Name | Metric | Description |
| --- | --- | --- |
| Skio: New Subscription Created | ```plaintext subscriptionCreated ``` | When a new subscription is created. |
| Skio: Billing Reminder Notification | ```plaintext subscriptionWillRenew ``` | When a subscription is about to renew. |
| Skio: Subscription Renewed | ```plaintext subscriptionRenewed ``` | When a subscription is successfully renewed. |
| Skio: Subscription Cancelled | ```plaintext subscriptionCancelled ``` | When a subscription is cancelled. |
| Skio: Subscription Reactivated | ```plaintext subscriptionReactivated ``` | When a subscription is reactivated. |
| Skio: Subscription Next Billing Date Updated | ```plaintext subscriptionNextBillingDateUpdated ``` | When a customer updates a subscription's next billing date. |
| Skio: Subscription Paused | ```plaintext subscriptionPaused ``` | When a subscription is paused. |
| Skio: Subscription Unpaused | ```plaintext subscriptionUnpaused ``` | When a subscription is unpaused. |
| Skio: Subscription Skipped | ```plaintext subscriptionSkipped ``` | When a subscription is skipped. |

### Billing & Payment Issues

| Event Name | Metric | Description |
| --- | --- | --- |
| Skio: Billing Attempt Failed | ```plaintext billingAttemptFailed ``` | When Skio fails to renew a subscription. |
| Skio: Card Expiration Notification | ```plaintext cardWillExpire ``` | When a customer card is about to expire. |
| Skio: 3DS Verification Required | ```plaintext threeDSVerification ``` | When a payment requires [3DS verification.](/help/docs/managing-subscriptions-handling-subscription-renewals-that-require-3d-secure-3ds-verification) |

### Subscription Management

| Event Name | Metric | Description |
| --- | --- | --- |
| Skio: Subscription Lines Added | ```plaintext subscriptionLinesAdded ``` | When a subscription line(s) is/are added. |
| Skio: Subscription Lines Removed | ```plaintext subscriptionLinesRemoved ``` | When a subscription line(s) is/are removed. |
| Skio: Subscription Lines Updated | ```plaintext subscriptionLinesUpdated ``` | When a subscription line(s) is/are updated. |
| Skio: Subscription Split | ```plaintext subscriptionSplit ``` | When a subscription is created from a split. |
| Skio: Subscription Merged | ```plaintext subscriptionMerged ``` | When a subscription is cancelled from a merge. |
| Skio: Subscription Mergeable | ```plaintext subscriptionMergeable ``` | When there's subscriptions that can be merged together. |
| Skio: Subscription Auto Merged Billing | ```plaintext subscriptionAutoMergedBilling ``` | When subscriptions are merged into a [single order for billing.](/help/docs/auto-merge-billing) |
| Skio: Order Placed (Subscription Upgrade Eligible) | ```plaintext subscriptionUpgradeEligibleOrderPlaced ``` | When an order is placed that [makes a subscription eligible for an upgrade.](/help/docs/convert-one-time-buyers-to-subscribers-with-quick-actions) |

### Inventory & Stock

| Event Name | Metric | Description |
| --- | --- | --- |
| Skio: Subscription Item Out of Stock | ```plaintext subscriptionOutOfStock ``` | When any item in a subscription is out of stock. |
| Skio: Item Back in Stock | ```plaintext oosMissedBillingBackInStock ``` | When an out of stock item missed in the previous billing is back in stock. |

### Customer Retention & Flow

| Event Name | Metric | Description |
| --- | --- | --- |
| Skio: Subscription Went Through Cancel Flow | ```plaintext subscriptionWentThroughCancelFlow ``` | When a subscription is saved during the [cancel flow](/help/docs/getting-started-with-cancel-flows). |
| Skio: Surprise and Delight Rule Applied | ```plaintext surpriseAndDelightRuleApplied ``` | When a [surprise product or discount](/help/docs/how-to-set-up-a-surprise-delight-rule) is applied to a subscription. |
| Skio: Surprise and Delight Gift Swapped | ```plaintext surpriseAndDelightGiftSwapped ``` | When a [surprise and delight gift](/help/docs/how-to-set-up-a-surprise-delight-rule) is swapped for a different product. |
| Skio: Journey Notification Triggered | ```plaintext journeyNotificationTriggered ``` | When [a journey notification](/help/docs/understanding-skio-journeys#what-actions-are-available-in-journeys) action is triggered. |

### Gifts

| Event Name | Metric | Description |
| --- | --- | --- |
| Skio: Prepaid Gift Received | ```plaintext prepaidGiftReceived ``` | When a [prepaid gift](/help/docs/how-to-set-up-prepaid-gift-subscriptions) is received for a recipient. |

### Loyalty & Credits

| Event Name | Metric | Description |
| --- | --- | --- |
| Skio: Credits Will Expire | ```plaintext creditsWillExpire ``` | When [customers' credits](/help/docs/how-to-set-up-credits) are about to expire in a given month. |
| Skio: Credits Expired | ```plaintext creditsExpired ``` | A [customer's credits](/help/docs/how-to-set-up-credits) have expired. |
| Skio: Credits Received | ```plaintext creditsReceived ``` | A customer has received credits. |
| Skio: Credits Spent | ```plaintext creditsSpent ``` | A customer has spent credits. |
| Skio: Loyalty Tier Upgraded | ```plaintext loyaltyTierUpgraded ``` | When [customers' loyalty tier](/help/docs/how-to-set-up-tiers-and-rewards) is upgraded. |
| Skio: Loyalty Tier Downgraded | ```plaintext loyaltyTierDowngraded ``` | When [customers' loyalty tier](/help/docs/how-to-set-up-tiers-and-rewards) is downgraded. |
| Skio: Loyalty Tier Changed | ```plaintext loyaltyTierChanged ``` | When [customers' loyalty tier](/help/docs/how-to-set-up-tiers-and-rewards) is changed due to program change. |
| Skio: Loyalty Rewards Applied | ```plaintext loyaltyRewardsApplied ``` | When customers receive a loyalty reward. |

### Winback

| Event Name | Metric | Description |
| --- | --- | --- |
| Skio: Winback Initiated | ```plaintext winbackInitiated ``` | When a [winback flow](/help/docs/getting-started-with-winbacks) is initiated for a subscriber. |
| Skio: Winback Redeemed | ```plaintext winbackRedeemed ``` | When a subscriber redeems a [winback offer.](/help/docs/getting-started-with-winbacks) |
| Skio: Winback Custom Notification | ```plaintext winbackCustomNotification ``` | When a [custom winback notification](/help/docs/how-to-set-up-winbacks-with-klaviyo-or-postscript) is sent to a subscriber. |

### Streaks

| Event Name | Metric | Description |
| --- | --- | --- |
| Skio: Streak Will Expire | ```plaintext streakWillExpire ``` | When a [subscriber's streak](/help/docs/streaks-guide) is about to expire. |
| Skio: Streak Expired | ```plaintext streakExpired ``` | When a [subscriber's streak](/help/docs/streaks-guide) has expired. |

### Referrals

| Event Name | Metric | Description |
| --- | --- | --- |
| Skio: Referral Code Generated | ```plaintext referralCodeGenerated ``` | When a [referral code](/help/docs/how-to-set-up-referrals) is generated for a customer. |
| Skio: Referral Referrer Reward Generated | ```plaintext referralReferrerRewardGenerated ``` | When a reward is generated for the customer who [made the referral.](/help/docs/how-to-set-up-referrals) |

### Credits event metrics

| **Event Name** | **Trigger** | **Data Included** | **Suggested Use Cases** |
| --- | --- | --- | --- |
| **Credits Will Expire** | Sent when a customer’s credits are about to expire. | - `creditsExpiring` (Number of credits expiring) - `siteCurrencyValue` (Equivalent currency value of expiring credits) - `expirationMonths` (How many months before expiration) - `creditsExpiringDate` (Exact expiration date) | Send reminders encouraging customers to use their credits before they expire. |
| **Credits Expired** | Sent when a customer’s credits have expired. | - `creditsExpired` (Number of expired credits) - `siteCurrencyValue` (Equivalent currency value of expired credits) - `creditsExpiringDate` (Expiration date of the credits) | Inform customers of expired credits and offer a small incentive to stay engaged. |
| **Credits Received** | Sent when a customer earns new credits. | - `credits` (Number of credits earned) - `siteCurrencyToCreditRate` (Conversion rate of credits to site currency) - `siteCurrencyValue` (Equivalent currency value of the credits) - `creditApplicationType` (Source of the earned credits: e.g., referral, purchase, promotion) | Notify customers when they earn credits and suggest ways to use them. |
| **Credits Spent** | Sent when a customer redeems their credits. | - `credits` (Number of credits used) - `siteCurrencyValue` (Equivalent currency value of redeemed credits) - `discountCode` (If applicable, the code applied to their order) | Confirm redemption and suggest new ways to earn more credits. |

### Loyalty Tier event metrics

| **Event Name** | **Trigger** | **Data Included** | **Suggested Use Cases** |
| --- | --- | --- | --- |
| **Loyalty Tier Upgraded** | Sent when a customer moves up to a higher loyalty tier. | - `tierName` (New tier the customer entered) - `previousTierName` (Previous tier before upgrade) | Celebrate the upgrade, highlight new benefits, and encourage further engagement. |
| **Loyalty Tier Downgraded** | Sent when a customer moves down to a lower loyalty tier. | - `tierName` (New, lower tier) - `previousTierName` (Previous, higher tier) | Notify customers of the downgrade and suggest ways to regain their previous tier. |
| **Loyalty Tier Changed** | Sent when a customer’s tier changes due to program adjustments. | - `tierName` (Updated tier) - `previousTierName` (Previous tier, if applicable) | Inform customers about changes to their loyalty tier and any new benefits. |

### Rewards event metrics

| **Event Name** | **Trigger** | **Data Included** | **Suggested Use Cases** |
| --- | --- | --- | --- |
| **Loyalty Rewards Applied** | Sent when a customer receives a loyalty reward. | - `rewardNames` (List of rewards applied to the customer’s account) | Notify customers of their earned rewards and encourage immediate use. |

### Referrals event metrics

| **Event Name** | **Trigger** | **Data Included** | **Suggested Use Cases** |
| --- | --- | --- | --- |
| **Referral Code Generated** | Sent when a customer (referrer) generates a new referral code. | - `referralCode` (Referral code used) - `RewardType` (Type of reward attached to the referral) - `RewardConfig` | Track code generation and encourage sharing. |
| **Referral Reward Generated** | Sent when a customer (referrer) earns a reward for a successful referral (referee). | - `referralCode` (Referral code used) - `discountCode` (optional, the code attached to the discount itself. Learn more in [our Referral help doc here](https://help.skio.com/hc/en-us/articles/37493210086939-How-to-set-up-Referrals#h_01K1C15G3Z22EN4ZR4MGHP8RXF)) - `rewardType` (The type of reward, such as fixed or percent discount) - `rewardConfig` (Additional information about the discount configuration) - `refereeEmail` (Email of the referred customer) - `refereeName` (Name of the referred customer) - `refereeStorefrontUserId` | Trigger reward emails and attribute referral success. |

## How to use variables in Klaviyo

Once you know which properties an event includes, here's how to reference them in your Klaviyo emails and SMS messages.

### Event-triggered flows

Use `{{ event.propertyName|default:'' }}`

### Profile-based campaigns

Use `{{ person.propertyName|default:'' }}`

### Common examples

| What you want to show | Variable |
| --- | --- |
| Credits earned or spent (from event) | `{{ event.credits\|default:'' }}` |
| Dollar value of credits | `{{ event.siteCurrencyValue\|default:'' }}` |
| Customer's current tier | `{{ event.loyaltyCurrentTierName\|default:'' }}` |
| New tier after upgrade/downgrade | `{{ event.tierName\|default:'' }}` |
| Previous tier | `{{ event.previousTierName\|default:'' }}` |
| Credits expiring | `{{ event.creditsExpiring\|default:'' }}` |
| Current credit balance (profile) | `{{ person.skio_credits\|default:'' }}` |
| Current tier (profile) | `{{ person.skio_membership_tier\|default:'' }}` |

> [!NOTE]
> You can preview the exact variable names available in your specific flow by [previewing event variables in Klaviyo](/help/docs/how-to-preview-and-test-klaviyo-flows-with-skio#step-2-preview-event-variables-inside-the-flow).

## Customer Profile Properties in Klaviyo

In addition to event triggers, Skio updates **customer profiles** in Klaviyo with **loyalty-related properties**:

| **Property** | **Description** | **Example Value** |
| --- | --- | --- |
| skio_credits | Customer’s current credit balance. | `150` |
| skio_membership_tier | Customer’s current loyalty tier. | `Gold` |

These properties allow for **segmentation** and **personalized messaging**, such as:

- Sending targeted promotions to customers with **unused credits**.
- Offering **tier-exclusive deals** to customers in specific loyalty tiers.
- Segmenting by **credit balance**: To target all customers with a positive credit balance in Klaviyo, create a segment using: Properties about someone > `skio_credits` > greater than > 0

> [!NOTE]
> For the full list of loyalty and loss aversion profile properties, see [Skio event and profile properties in Klaviyo](/help/docs/skio-properties-sent-to-klaviyo#custom-properties)

## How to use Loyalty data in Klaviyo: Use cases

With these data points, you can create powerful Klaviyo flows:

**Expiring credits reminder**

- **Trigger**: **Credits Will Expire**
- **Use Data**:
  - Display the **exact number of expiring credits** (`creditsExpiring`).
  - Show the **equivalent currency value** (`siteCurrencyValue`).
  - Set the number of days before the end of the month to notify.
- **Example Subject Line**: 🚨 Use Your {{creditsExpiring}} Credits Before They Disappear!

**Reward confirmation and next steps**

- **Trigger**: **Loyalty Rewards Applied**
- **Use Data**:
  - Show **reward names** (`rewardNames`).
  - Provide information about how to use or redeem the reward.
- **Example Subject Line**: 🎉 You Just Earned {{rewardNames}} – Here’s How to Use It!

**Tier upgrade celebration**

- **Trigger**: **Loyalty Tier Upgraded**
- **Use Data**:
  - Show the **new tier** (`tierName`).
  - Highlight **exclusive benefits** for the upgraded tier.
- **Example Subject Line**: 🎊 Welcome to {{tierName}} – Exclusive Perks Await!

**Downgrade prevention**

- **Trigger**: **Loyalty Tier Downgraded**
- **Use Data**:
  - Show the **new tier** (`tierName`) and **previous tier** (`previousTierName`).
  - Encourage the customer to place another order or increase their LTV with a quick action.
- **Example Subject Line**: 😢 You moved to {{tierName}}, but here’s how to move back up!

## Additional help

By leveraging Skio’s loyalty event data in Klaviyo, you can craft highly personalized, automated campaigns that drive engagement, increase repeat purchases, and enhance customer retention.

For setup instructions and additional details, check out:

- [Getting started with Klaviyo](/help/docs/klaviyo-integration): Step-by-step instructions for connecting Klaviyo to your Skio store
- [Skio event and profile properties in Klaviyo](/help/docs/skio-properties-sent-to-klaviyo): Full reference for all event and profile properties, including loyalty and loss aversion