# Klaviyo: Email Marketing & SMS

### What is the Klaviyo integration?

The Klaviyo integration connects your Joy Subscription app with Klaviyo, a leading email and SMS marketing platform. This powerful integration automatically sends real-time subscription event data from Joy Subscriptions to Klaviyo, enabling you to create sophisticated automated marketing campaigns based on your customers' subscription behaviors.

### Why use this integration?

The Klaviyo integration helps you:

* **Automate transactional emails and SMS** for subscription events (renewals, cancellations, payment failures)
* **Segment your audience** using Joy's custom subscription properties
* **Send targeted campaigns** based on subscriber data and behavior
* **Improve customer retention** with personalized communication flows
* **Increase revenue** through automated win-back campaigns and upselling
* **Save time** by eliminating manual email management for subscription events

Common use cases include welcome sequences for new subscribers, payment failure notifications, cancellation prevention emails, and renewal reminders.

### Prerequisites

Before setting up the integration, ensure you have:

* An active Klaviyo account (free or paid)
* Joy Subscription installed
* Admin access to both your Shopify store and Klaviyo account
* Basic understanding of email marketing flows (helpful but not required)

### How to set up Klaviyo integration

#### Step 1: Connect to Klaviyo

1. From your Shopify admin, navigate to **Apps**
2. Click **Joy Subscription** to open the app
3. In the Joy Subscription dashboard, go to **Settings** in the left sidebar
4. Select **Integration** from the settings menu
5. Find the **Klaviyo** integration option
6. Click the **Connect** button

**Connection Process:**

1. You'll be redirected to Klaviyo's authorization page
2. Log in to your Klaviyo account if prompted
3. Review the permissions that Joy Subscription is requesting
4. Click **Allow** to grant access
5. You'll be redirected back to Joy Subscription with a "Connected" status

**If Connection Fails:**

* Ensure you're logged into the correct Klaviyo account
* Check that your Klaviyo account has the necessary permissions
* Try clearing your browser cache and attempting the connection again

#### Step 2: Get Started with Sample Events

Once connected, you'll want to test the integration with sample data:

1. In the Klaviyo integration section, locate **Step 2: Get started with sample events**
2. Click the **Trigger events** button
3. This sends test data for all Joy subscription events without creating actual subscriptions

**What This Does:**

* Creates sample events in your Klaviyo account for testing
* Allows you to see what data Joy sends to Klaviyo
* Helps you set up flows and segments before real customer data flows through
* Ensures the integration is working properly

**Verify Sample Events:**

1. Go to your Klaviyo dashboard
2. Navigate to **Analytics > Metrics**
3. Look for Joy Subscription events (they'll be prefixed with your app name)
4. Click on individual events to see the data structure and properties

#### Step 3: Sync Existing Customer Data

To sync your current subscribers with Klaviyo:

1. In the integration setup, find **Step 3: Sync existing customer data**
2. Click the **Sync data** button
3. Confirm that you want to sync existing subscriber information

**Important Notes:**

* The sync process may take **48 to 72 hours** depending on the number of profiles
* Existing customer profiles will be updated with subscription information
* New profiles will be created for subscribers not already in Klaviyo
* You can monitor sync progress in the integration dashboard

**During Sync Process:**

* New subscription events will continue to sync in real-time
* You can start building flows and segments while the historical sync completes
* Don't disconnect the integration while sync is in progress

### Setting Up Klaviyo Flows

After integration setup, create automated flows in Klaviyo:

#### Essential Flows to Create:

**1. Welcome Series for New Subscribers**

* Trigger: Subscription created event
* Content: Welcome message, subscription details, customer portal access

**2. Payment Failed Recovery**

* Trigger: Payment failed event
* Content: Payment update instructions, customer support contact

**3. Cancellation Prevention**

* Trigger: Subscription cancelled event
* Content: Win-back offer, feedback request, pause option

**4. Renewal Reminders**

* Trigger: X days before renewal date
* Content: Upcoming charge notification, manage subscription options

#### Setting Up a Flow:

1. In Klaviyo, go to **Flows > Create Flow**
2. Choose **Create from Scratch**
3. Set up your trigger using Joy Subscription events
4. Add email/SMS actions with your content
5. Configure timing and conditions
6. Test and activate the flow

### Segmentation and Targeting

Use Joy's subscription data to create targeted segments:

#### Useful Segments:

* **Active Subscribers:** Customers with active subscriptions
* **High-Value Customers:** Subscribers with high-frequency or high-value plans
* **At-Risk Subscribers:** Customers with recent payment failures
* **Long-Term Customers:** Subscribers active for 6+ months

#### Creating Segments:

1. In Klaviyo, go to **Lists & Segments > Create List/Segment**
2. Choose **Segment**
3. Add conditions using Joy Subscription properties
4. Name and save your segment
5. Use segments for targeted campaigns and flow conditions

### Monitoring and Optimization

#### Track Integration Performance:

**In Joy Subscription:**

* Monitor integration status in Settings > Integration
* Check sync completion progress
* Review event sending success rates

**In Klaviyo:**

* Analyze flow performance metrics
* Monitor email deliverability rates
* Track revenue attribution from subscription flows

#### Best Practices:

* **Start Simple:** Begin with basic flows before adding complexity
* **Test Thoroughly:** Use sample events to test flows before going live
* **Monitor Performance:** Regularly check flow metrics and optimize
* **Personalize Content:** Use subscription data for personalized messaging
* **Maintain List Hygiene:** Regularly clean your email lists for better deliverability

### Troubleshooting Common Issues

**Integration Shows "Not Connected":**

* Re-authorize the connection in Settings > Integration
* Check Klaviyo account permissions
* Contact support if issue persists

**Events Not Appearing in Klaviyo:**

* Verify integration status is "Connected"
* Check if events are being triggered in Joy
* Allow up to 15 minutes for events to appear in Klaviyo

**Sync Taking Too Long:**

* Large datasets can take up to 72 hours
* Contact support if sync exceeds this timeframe
* New events continue to sync in real-time during historical sync

### Summary and Next Steps

Your Klaviyo integration is now set up to automatically send subscription data and enable powerful email and SMS automation. The system will:

1. Send real-time subscription events to Klaviyo
2. Sync existing customer data (may take 48-72 hours)
3. Enable segmentation based on subscription behavior
4. Support automated flows for subscription events