Overview
The Klaviyo integration allows you to export emails directly from Migma to Klaviyo with a single click. All Liquid merge tags are automatically preserved, and emails can be used in campaigns, flows, and templates.One-Click Export: Create beautiful emails in Migma, then export them to Klaviyo instantly via API. No manual copying, no broken formatting, and merge tags are automatically preserved.
Campaign Export
Push campaigns directly to Klaviyo
Template Library
Save to Klaviyo template library
Merge Tags
Liquid variables automatically preserved
Flow Integration
Use in automated flows and sequences
Setup Klaviyo Connection
1
Get Klaviyo API Key
In Klaviyo:
- Go to Account → Settings → API Keys
- Click “Create Private API Key”
- Give it a name like “Migma Integration”
- Grant Full Access permissions:
- Lists & Segments: Read/Write
- Templates: Read/Write
- Campaigns: Read/Write
- Copy your API Key
2
Connect in Migma
In Migma:
- Navigate to Settings → Integrations → Marketing Platforms
- Click “Connect Klaviyo”
- Paste your API Key
- Click “Authorize”
3
Select Lists
Choose which Klaviyo lists to sync:Select the lists you want to access from Migma:
- ☑ Main Newsletter List
- ☑ VIP Customers
- ☑ Abandoned Cart Segment
- ☐ Test List
4
Map Properties
Map Migma fields to Klaviyo properties:
Migma automatically detects custom properties and maps them.
| Migma Field | Klaviyo Property |
|---|---|
email | |
| First Name | $first_name |
| Last Name | $last_name |
| Phone | $phone_number |
| Custom Fields | Auto-detected |
5
Test Connection
Click “Test Connection” to verify:
- ✅ API authentication successful
- ✅ Lists accessible
- ✅ Properties mapped correctly
One-Click Export to Klaviyo
Export as Campaign
Create a campaign directly in Klaviyo:1
Create Email in Migma
Design and finalize your email using Migma’s AI or visual editor
2
Click Export
In the email editor, click “Export” → “Klaviyo Campaign”
3
Configure Campaign Settings
In the export dialog:
4
Export via API
Click “Export to Klaviyo”Migma automatically:
- ✅ Creates campaign in Klaviyo via API
- ✅ Uploads email HTML
- ✅ Preserves all Liquid merge tags
- ✅ Hosts images on CDN
- ✅ Sets campaign as draft
5
Finish in Klaviyo
Go to Klaviyo to:
- Review the campaign
- Schedule send time
- Send test emails
- Launch campaign
Export as Template
Save to Klaviyo template library for reuse:1
Export as Template
Click “Export” → “Klaviyo Template”
2
Template Settings
Configure:
- Template name: “Product Showcase Template”
- Category: “Newsletter”
- Tags: “product”, “seasonal”
- Description: “Reusable product showcase layout”
3
API Upload
Migma uploads the template via Klaviyo APITemplate appears in:
Klaviyo → Templates → Saved Templates
4
Use in Campaigns and Flows
Use the template for:
- New campaigns
- Automated flows
- A/B testing
- Quick email creation
Merge Tags & Liquid Variables
Migma automatically preserves Klaviyo’s Liquid templating syntax. Use merge tags in your prompts, and they’ll work perfectly in Klaviyo.Profile Properties
Event Properties
Conditional Logic
Default Values
Using Merge Tags in Migma
In Prompts
Tell Migma to include merge tags in your prompt:Visual Editor
When editing in Migma’s visual editor, you can:- Type merge tags directly:
{{ first_name }} - They’ll be preserved when exporting to Klaviyo
- Preview shows placeholder values
Common Examples
Abandoned Cart Email:Flow Integration
Use Migma templates in Klaviyo automated flows:Setup Flow Template
1
Export Template
Export your email as a template to Klaviyo
2
Create/Edit Flow
In Klaviyo, create or edit an automated flow:
- Welcome series
- Abandoned cart
- Post-purchase
- Win-back campaign
3
Add Email Action
- Add an “Email” action to your flow
- Click “Select Template”
- Choose your Migma template
4
Configure Triggers
Set up flow triggers and timing:
- Trigger: When someone joins a list
- Delay: Immediate or timed
- Filters: Segment conditions
Common Flow Use Cases
Welcome Series
Welcome Series
Email 1: Welcome + brand introduction
- Trigger: List signup
- Delay: Immediate
- Merge tags:
{{ first_name }},{{ person.signup_source }}
- Delay: 2 days after Email 1
- Merge tags:
{{ event.browsed_category }}
- Delay: 5 days after Email 2
- Conditional:
{% if person.purchase_count == 0 %}
Abandoned Cart
Abandoned Cart
Email 1: Cart reminder
- Trigger: Started checkout, didn’t complete
- Delay: 1 hour
- Merge tags:
{{ event.product_name }},{{ event.checkout_url }}
- Delay: 24 hours
- Conditional discount code
- Delay: 48 hours
- Urgency messaging
Post-Purchase
Post-Purchase
Email 1: Order confirmation
- Trigger: Placed order
- Delay: Immediate
- Merge tags:
{{ event.order_id }},{{ event.order_total }}
- Trigger: Order fulfilled
- Merge tags:
{{ event.tracking_url }}
- Delay: 7 days after delivery
- Merge tags:
{{ event.purchased_products }}
List & Segment Sync
Sync Audiences
Bidirectional sync between Migma and Klaviyo:Export subscribers from Migma to Klaviyo lists
Import Klaviyo lists into Migma
Automatic field mapping
Custom property sync
Configure Sync
- Settings → Integrations → Klaviyo
- Click “Manage Lists”
- Select sync direction:
- ○ Migma → Klaviyo only
- ● Bidirectional (recommended)
- ○ Klaviyo → Migma only
- Choose sync frequency:
- Real-time (instant sync)
- Hourly batch
- Daily batch
Best Practices
Use Merge Tags Strategically
Use Merge Tags Strategically
Test Before Sending
Test Before Sending
Always test with real data:
- Export template to Klaviyo
- Create test campaign
- Send to test profiles with:
- Complete data
- Missing data (test defaults)
- Edge cases
- Check rendering across devices
- Verify links and merge tags work
Template Organization
Template Organization
Keep templates organized:
- Use clear naming: “Abandoned Cart - v2”
- Add categories: Newsletter, Transactional, Promotional
- Tag by season/campaign: “holiday-2024”, “summer-sale”
- Document merge tag requirements
Monitor Performance
Monitor Performance
Track template performance:
- Compare AI-generated vs manual emails
- A/B test different designs
- Monitor open/click rates
- Iterate based on data
Troubleshooting
Connection Failed
Connection Failed
Problem: Can’t connect Klaviyo to MigmaSolutions:
- Verify API key is correct (no extra spaces)
- Check API key has Full Access permissions
- Ensure API key hasn’t been revoked
- Try creating a new API key
- Contact support if issue persists
Merge Tags Not Working
Merge Tags Not Working
Export Failed
Export Failed
Problem: Export to Klaviyo failsSolutions:
- Check API connection is active
- Verify you have permission to create campaigns/templates
- Ensure list/segment exists in Klaviyo
- Check for special characters in campaign name
- Try exporting as template first
Images Not Loading
Images Not Loading
Problem: Images broken in KlaviyoSolutions:
- Verify images uploaded to Migma CDN
- Check image URLs are public
- Ensure Klaviyo can access external images
- Try re-uploading images in Migma
- Check image file sizes (< 1MB recommended)
Next Steps
Email Service Providers
Setup SES, Resend, or SendGrid
Mailchimp Integration
Export to Mailchimp
Sending Emails
Send to your audience
Export Options
All export formats