How to set up the LoyaltyLion integration

Before you start

• You need an active LoyaltyLion account.

• You need access to your Shopify admin to install apps and edit your theme.

• You need access to your Skio Dashboard to generate an API key and add a webhook.

What is the LoyaltyLion integration?

LoyaltyLion is a Shopify loyalty and rewards app. Connecting it to Skio lets your subscribers earn and redeem LoyaltyLion rewards on their subscription orders, and lets you optionally display LoyaltyLion points and rewards inside the Skio Customer Portal.

See LoyaltyLion’s help center here.

How to set up the LoyaltyLion integration

Step 1: Add the webhook

From your LoyaltyLion dashboard, in the bottom left corner, click Integrations. Click Skio and follow the on-screen instructions to start the setup:

1. Copy the webhook URL that LoyaltyLion provides: https://api.loyaltylion.com/skio/v1/62424/webhooks

2. In a new tab, go to your Skio Dashboard and click API and Integrations > API Keys.

3. Click the Webhooks tab.

4. Paste the webhook URL from LoyaltyLion into the field and click Add webhook.

5. Once it's added, a token appears in the Token column. Click Copy to copy this token.

6. Go back to the LoyaltyLion setup page and paste the token where prompted.

Step 2: Add the API key

1. Back in your Skio Dashboard, click the API tab (still under API and Integrations > API Keys).

2. Enter a name for your API key, such as LoyaltyLion, then click Generate API key.

3. Copy the generated key.

4. Paste it into the LoyaltyLion setup page, then click Submit to finish connecting Skio.

Warning: You can only view your API key once. Copy it right away and store it somewhere safe.

Setting up a LoyaltyLion reward for subscriptions

LoyaltyLion offers a few reward types you can make available to your subscribers. The two most relevant for subscriptions are the discount reward and the Free product (subscriber) reward.

Discount reward

By default, a LoyaltyLion reward doesn't apply to subscription orders. To make a discount reward work with Skio subscriptions, you need to set its purchase type when you create it in LoyaltyLion.

1. In your LoyaltyLion account, go to Program > Rewards.

2. Click New Reward, then Discount.

3. Under Purchase type, choose Subscription Purchases or Both. Choosing One-Off Purchases only will not let the reward apply to a subscription.

4. If you want the discount to apply to more than one subscription payment, check Apply discount to future subscription payments, then choose whether it applies to a limited number of payments or to all future payments.

5. Finish setting up the reward and click Create Reward.

Free product (subscriber) reward

This reward lets a subscriber redeem points for a free product. Unlike the discount reward above, it's redeemed directly from the product page rather than as a code applied in the Skio Customer Portal.

1. In your LoyaltyLion account, go to Program > Rewards.

2. Click New Reward.

3. Under Free products, select Free product (subscriber).

4. Under Product, click Find product and select the product (and variants) this reward applies to.

5. Under Reward details, enter the Points cost.

6. Optional: under Customer redemption limit, check Limit how many times a customer can redeem this reward and set how often — for example, 1 time per day.

7. Optional: under Reward inventory, check Add a LoyaltyLion inventory limit to cap the total number of times this reward can be redeemed.

8. Under Display, confirm the Title and Media. LoyaltyLion pulls these from the product by default — check Use this image wherever this reward appears to keep the reward image in sync with the product image.

9. Optional: add Terms and conditions.

10. Under Status, set the reward to Active when you're ready for customers to see it.

11. Under Availability, click Manage to confirm which Channels and Countries the reward is available in.

12. Click Create.

Setting up a Subscription Challenge

Challenges reward subscribers with points or another reward as their order count climbs, with an optional recurring bonus once they've reached every milestone.

Create the challenge

1. In your LoyaltyLion account, go to Engagement > Challenges.

2. Click Create challenge and select Subscription Challenge from the template list.

3. Under Challenge details, enter a Challenge name. This is only visible in your LoyaltyLion admin, not to customers.

4. Under Milestones, set the points or reward for each order-count milestone. Click Edit on an existing milestone to change it, or Add milestone to add another. Each milestone fires once, when the customer reaches that order count.

Setting up an ongoing reward

An ongoing reward keeps rewarding subscribers with a repeating bonus after they've completed every milestone.

1. Under Ongoing reward, click Add ongoing reward.

2. Choose the Reward type from the dropdown — for example, Points.

3. Enter the Amount to award each time.

4. Under Every, set how often the reward repeats — for example, every 1 order.

5. Optional: check Limit how many times it can fire to cap the number of times this reward pays out.

6. Optional: add a Label — this is how the reward is named on the loyalty page and in the customer's reward history.

7. Optional: add a Recurring panel description, which appears as a short subtitle wherever the ongoing reward is shown.

Notifications and display

1. Under Notifications, decide whether to keep Notify customers when this challenge awards points or a reward checked. This shows an on-site notification for each payout and when the challenge completes.

2. Under Display, set the Customer-facing title — for example, Subscriber rewards — and an optional Description.

3. Choose a Progression style — Linear, Steps, or Stacked — to control how the milestone progress bar looks to customers. Use the Preview panel to check how it will look before publishing.

When you're ready, click Save draft to keep working on it later, or Create and launch to make the challenge live.

How customers redeem LoyaltyLion rewards on a Skio subscription

Once a subscriber has enough points, they can claim a reward and apply it to their subscription from the Skio Customer Portal.

1. The customer claims their reward from the LoyaltyLion Rewards page (or from LoyaltyLion components embedded in the Skio Customer Portal, if you've added them).

2. The customer copies the discount code LoyaltyLion gives them.

3. In the Skio Customer Portal, the customer scrolls to the Discounts section, pastes the code, and clicks Apply.

Note: You can also display LoyaltyLion points and rewards directly inside the Skio Customer Portal using a custom code block. Go to Storefront > Customer Portal > Branding, and add LoyaltyLion's embed code to Custom block and Custom CSS. LoyaltyLion provides the exact code to use in their Skio integration manual. Customers need to be logged in for these components to display.

FAQ