How to set up the Klaviyo Integration

What is the Klaviyo Integration for?

The Klaviyo integration allows you to sync your Skio subscription data directly with Klaviyo, enabling you to build targeted email flows, segment customers based on subscription behavior, and trigger automated campaigns. Once connected, Skio will send subscription events and customer data to Klaviyo in real time, giving you the tools to reduce churn, increase LTV, and personalize your messaging at scale.

Learn more about the Klaviyo Integration in our guide here.

How do I set up the Klaviyo Integration in Skio?

Step 1: Enable the Klaviyo integration

1. In your Skio Dashboard, go to API & Integrations > Integrations.

2. Find the Klaviyo tile and click Enable.

3. You'll be redirected to the Klaviyo integration page within Skio.

Step 2: Connect your Klaviyo account

1. On the Klaviyo integration page, click Connect.

2. You'll be taken to a Klaviyo authorization page to accept permissions and authorize the Skio app.

3. Click Allow to complete the connection.

   

Once authorized, Skio will automatically connect to your Klaviyo account.

Step 3: Complete setup

After the connection is complete, the integration will be enabled automatically. You'll see the following options on the Klaviyo management page:

Enable/disable the integration: Use the toggle switch in the top right corner of the management card to enable or disable the integration. Disabling the integration will keep your configuration but stop sending all events to Klaviyo.

Integration ID: You'll see an Integration ID displayed in the management card. If you're planning to connect multiple Skio accounts to the same Klaviyo account (e.g., separate stores for different markets), you'll use this ID. Otherwise, you can ignore it and proceed with event setup.

Step 4: Backfilling Skio customers

After the connection is complete, click Backfill.

This will sync all existing Skio customers to your Klaviyo account, even if they haven't triggered a subscription event yet. Backfilling ensures your Klaviyo segments and flows reflect your full customer base from the start.

Step 5: Add subscription events

1. In the Events section on the Klaviyo management page, click + Add Event.

2. Select the subscription event you want to send to Klaviyo (e.g., subscription created, payment failed, cancellation).

When an event triggers in Skio, the platform will send the event along with relevant event properties and data to Klaviyo. This allows you to build flows and segments based on real-time subscription behavior.

subscriptionCreated

subscriptionWillRenew

subscriptionRenewed

subscriptionCancelled

subscriptionReactivated

subscriptionNextBillingDateUpdated

subscriptionPaused

subscriptionUnpaused

subscriptionSkipped

billingAttemptFailed

cardWillExpire

threeDSVerification

subscriptionLinesAdded

subscriptionLinesRemoved

subscriptionLinesUpdated

subscriptionSplit

subscriptionMerged

subscriptionMergeable

subscriptionAutoMergedBilling

subscriptionUpgradeEligibleOrderPlaced

subscriptionOutOfStock

oosMissedBillingBackInStock

subscriptionWentThroughCancelFlow

surpriseAndDelightRuleApplied

surpriseAndDelightGiftSwapped

journeyNotificationTriggered

prepaidGiftReceived

creditsWillExpire

creditsExpired

creditsReceived

creditsSpent

loyaltyTierUpgraded

loyaltyTierDowngraded

loyaltyTierChanged

loyaltyRewardsApplied

winbackInitiated

winbackRedeemed

winbackCustomNotification

streakWillExpire

streakExpired

referralCodeGenerated

referralReferrerRewardGenerated

Some events, like Skio: Billing Reminder Notification, require additional configuration such as the number of days before the billing date or the subscription type to trigger for.

Step 6: Send a test event

After adding an event, click Send Test to push a test event to Klaviyo.

Sending a test event ensures the metric populates in Klaviyo as an available metric for segmentation and flow triggers. Repeat this step for each event you add during initial setup.

If you don't see an event in Klaviyo after adding it in Skio, make sure you clicked Send Test for that event. Klaviyo only populates metrics after the webhook fires at least once, so sending a test event ensures it appears immediately.

Viewing event history and properties

Learn more in our integration event history doc here.

Step 1: Navigate to event history

Click the History tab under the Backfill Klaviyo profiles section.

You'll see a table displaying all events sent from Skio to Klaviyo, including:

• Timestamp: When the event was sent

• Customer: The customer's name and email

• Subscription ID: The unique identifier for the subscription

• Event name: The type of event (e.g., Billing reminder notification)

• Status: Whether the event was successfully delivered

Use the date picker to filter events by a specific date range, or search by email, event name, or subscription ID.

Step 2: View detailed event data and properties

To see the full data payload for a specific event:

1. n the event history table, click View data next to the event you want to inspect.

2. Review the Event details panel, which includes:

   • Summary: Timestamp, customer name, subscription ID, event name, and delivery status

   • Event data: The full JSON payload sent to Klaviyo, including customer properties, subscription details, and any custom fields

You can click Copy JSON to copy the event properties and data for troubleshooting or internal review.

How to connect multiple Skio accounts to one Klaviyo account

If you have multiple Skio/Shopify accounts (e.g., separate stores for different international markets), you can connect them all to the same Klaviyo account using your Integration ID.

1. Navigate to the Klaviyo management page on your first Skio account and copy the Integration ID from the management card.

2. Navigate to the Klaviyo management page on your second Skio account.

3. Click Link an existing integration (do not click Connect, as this will disable your original integration).

4. Paste the Integration ID into the input box.

5. Enable the integration using the toggle switch in the top right corner of the card.

6. Repeat steps 2–5 for each additional Skio account you want to connect.

Make sure you've completed the standard integration setup on your first Skio account.

Adding your Merchant Success Manager to your Klaviyo account (optional)

To ensure Skio's team can assist you in resolving any issues or questions as quickly as possible, add your Merchant Success Manager and success@skio.com as users with full access to your Klaviyo account. This is optional, but it eliminates additional steps and speeds up turnaround time for future support requests.

The invitation to Klaviyo access only lasts 12 hours, so make sure to notify success@skio.com immediately after sending the invitation to ensure it's accepted.

FAQ