Klaviyo integration¶

Connect your Klaviyo account to Dxtra to manage email and SMS subscriptions, sync consent preferences, and handle data subject requests for your e-commerce marketing. Klaviyo may be available as a pre-built processor or can be integrated through custom integration.

What you can do¶

• Access Requests — Export subscriber data including email/SMS history, engagement metrics, and preferences
• Deletion Requests — Remove subscribers from all Klaviyo lists and delete their data
• Consent Management — Sync email and SMS consent preferences in real-time
• List Management — Manage subscribers across segments and automated flows
• E-commerce Compliance — Handle data requests for e-commerce subscribers and customers

Prerequisites¶

• Active Klaviyo account
• Dxtra workspace with admin access
• Klaviyo account admin access to generate API key

Setup instructions¶

Step 1: Check for Pre-Built Integration¶

In your Dxtra dashboard:

1. Navigate to Integrations → Processors
2. Click Select Processor and search for "Klaviyo"
3. If Klaviyo appears in the dropdown, proceed to Step 2
4. If not visible, see Custom Integration below

Step 2: Generate Klaviyo API Key¶

In your Klaviyo account:

1. Log in to Klaviyo
2. Go to Account → Settings → API Keys
3. Click Create API Key
4. Select Private API Key
5. Copy the generated key (starts with pk_)

Keep this key secure—treat it like a password.

Step 3: Enter API Key in Dxtra¶

In the Dxtra onboarding wizard:

Data Processor Details: - Processor Name: Klaviyo (auto-filled) - Processor Category: Email Marketing (auto-filled)

API Authentication: 1. Paste your Klaviyo API key into the form 2. Dxtra fetches your Klaviyo lists, segments, and metrics to configure webhook flows

Step 4: Confirm Data Controller DID¶

Dxtra displays your Data Controller DID—your unique organization identifier.

• Review the DID for your records
• Use this in your compliance documentation
• Example: did:dep:06aaa630923db3f97b17834ddcc6ca0545fb371a1019f9b93551855daa5198a4

Step 5: Complete Onboarding¶

1. Review the connection details
2. Click Confirm and Onboard
3. Klaviyo now appears in your Manage Processors table

Data covered¶

Handling data subject requests¶

Access Requests¶

When a customer requests their data:

1. In Dxtra, create a new Data Subject Access Request
2. Enter the customer's email address
3. Dxtra retrieves their complete profile from Klaviyo:
4. Email and SMS subscription status
5. All list and segment memberships
6. Automated flow enrollments
7. Campaign engagement (opens, clicks)
8. Custom events and purchase history
9. Preferences and communication history
10. Generate export file in their requested format
11. Deliver to customer within your compliance timeline (typically one month for GDPR)

Consent Preference Management¶

Klaviyo syncs email and SMS preferences in real-time:

1. Customer updates preferences in Klaviyo (unsubscribe from email, SMS, or both)
2. Preference change automatically syncs to Dxtra
3. Dxtra reflects the change in the Processing Activity Log
4. Customer is removed from affected campaigns and automations
5. You maintain an audit trail of consent changes

Deletion Requests¶

When a customer requests deletion:

1. In Dxtra, create a Deletion Request
2. Verify customer identity
3. Select deletion scope:
4. Remove from all email lists
5. Remove from all SMS lists
6. Delete customer profile
7. Delete engagement history (opens, clicks, etc.)
8. Delete event history
9. Click Execute Deletion
10. Dxtra removes the customer from Klaviyo
11. Send deletion confirmation to customer

Monitoring the integration¶

Processing Activity Log¶

Track all Klaviyo activity:

1. Go to Processing Activity Log in Dxtra
2. Filter by Source: Klaviyo
3. View all profile updates, list changes, campaign sends, and events
4. Each event shows timestamp, type, and affected profile

Connection Status¶

Verify integration health:

1. Go to Manage Processors
2. Find Klaviyo in the table
3. Verify Klaviyo appears in the Manage Processors table
4. If status shows error:
5. API key may have been revoked
6. Klaviyo account may be inactive
7. API permissions may have changed

Custom integration¶

If Klaviyo is not available as a pre-built processor:

1. Use Custom Webhooks to configure Klaviyo event tracking
2. Use the GraphQL API to query and manage Klaviyo data manually

Contact support@dxtra.ai to discuss the best approach for your setup.

Troubleshooting¶

Connection Failed¶

Problem: "Failed to authenticate with Klaviyo" error

Check: 1. API key is correct and was copied completely 2. API key hasn't been revoked in Klaviyo account 3. Klaviyo account is active

Solution: 1. Generate a new API key in Klaviyo Settings 2. Update the key in Dxtra Processor settings 3. Click Verify to re-test connection

Missing Profile Data¶

Problem: Customer exists in Klaviyo but doesn't appear in Dxtra

Check: 1. Email address matches exactly (case-sensitive in some systems) 2. Profile is active in Klaviyo 3. Integration is active in the Manage Processors table

Solution: 1. Verify email in Klaviyo matches request exactly 2. Check for alternate email addresses on the profile 3. Try searching by phone number or custom ID 4. Manually re-sync from Processor settings

Sync Delays¶

Problem: Changes in Klaviyo take time to appear in Dxtra

Check: 1. Integration is active in the Manage Processors table 2. Klaviyo API is operational 3. Network allows data transfer between Klaviyo and Dxtra

Solution: 1. Wait 5-10 minutes for automatic sync 2. Manually trigger sync from Processor settings 3. Check Klaviyo API status page 4. Verify firewall/network allows outbound connections

Deletion Failed¶

Problem: Deletion request shows as failed

Check: 1. Profile still exists in Klaviyo 2. API key includes delete permissions 3. Profile is not in protected/archived state

Solution: 1. Confirm profile exists in Klaviyo 2. Verify API key has full subscriber management permissions 3. Try deletion again from Processor settings 4. Contact support@dxtra.ai if issue persists

Event Data Missing¶

Problem: Purchase events or custom events not appearing for customer

Check: 1. Events are being tracked in Klaviyo 2. Events are associated with correct customer profile 3. Sync includes event history

Solution: 1. Verify events exist in Klaviyo event log 2. Confirm events are linked to correct email/phone 3. Manually trigger data refresh in Processor settings 4. Check that profile is active and not archived

Best practices¶

1. Test with Sample Customer — Verify data retrieval with a test profile before handling real requests
2. Document Your Process — Train your team on access and deletion request procedures
3. Monitor List Health — Review segment and list membership regularly
4. Track Compliance — Monitor opt-out rates and consent changes
5. Communicate Privacy Practices — Let customers know you can handle data requests quickly

Security and compliance¶

• Data Encryption — Klaviyo API data encrypted in transit (TLS 1.2+)
• Key Storage — API keys encrypted at rest in Dxtra
• Access Control — Only admins with "Privacy & Compliance" role can access customer data (role name pending product team verification)
• Audit Trail — All access to customer data logged and auditable
• No Data Resale — Dxtra never sells, shares, or uses Klaviyo data for marketing

Related documentation¶

• Email Marketing Integrations — Overview of email platform integrations
• Mailchimp Integration — Alternative email marketing platform
• Data Subject Rights — Complete DSR handling guide
• Custom Integrations — Build custom Klaviyo workflows
• Processing Activity Log — Monitor integrations

Support¶

Having trouble? Get help:

• Check the Troubleshooting section above
• Review the FAQ
• Contact support@dxtra.ai with your processor details and error message

Next: Explore Mailchimp integration or analytics integrations.