Klaviyo Integration

Connect your Klaviyo account to AccessFuel to unlock powerful email marketing analytics including lifecycle health analysis, customer churn predictions, campaign performance tracking, and email/SMS consent insights.

Prerequisites

Before you begin, you'll need:

A Klaviyo account with admin access
Klaviyo Private API Key

Setup Guide

Follow these steps to connect Klaviyo to AccessFuel:

Step 1: Log into Klaviyo

Go to Klaviyo and log in to your account
Make sure you have admin permissions

Step 2: Navigate to API Keys

Click on your account name in the bottom left corner
Select Settings from the dropdown menu
Navigate to API Keys section

You can also go directly to https://www.klaviyo.com/settings/account/api-keys

Step 3: Create a Private API Key

In the API Keys section, find Private API Keys
Click Create Private API Key
Give your key a descriptive name like "AccessFuel Integration"
Select the following API scopes:

Required Scopes:
- Profiles: Read access
- Lists: Read access
- Segments: Read access
- Campaigns: Read access
- Flows: Read access
- Metrics: Read access
- Events: Read access
Click Create to generate your API key

Step 4: Copy Your API Key

Your new Private API Key will be displayed only once
Copy the key immediately and store it securely
Click Done after copying

Important: You won't be able to see this key again after closing the dialog. If you lose it, you'll need to create a new one.

Step 5: Verify API Key Format

Your Klaviyo Private API Key should:

Start with pk_ (e.g., pk_1234567890abcdefghijklmnop)
Be approximately 30-40 characters long
Not contain spaces or special characters

Step 6: Send Us the API Key

Enter the following in Settings > Integrations:

API Key: Your Klaviyo Private API Key (starts with pk_)
Account Name (optional): Your Klaviyo account name for reference
Start Date (optional): The date from which you want to sync data (format: YYYY-MM-DDTHH:mm:ssZ)

Example start date: 2024-01-01T00:00:00Z. If not provided, we'll sync all available historical data.

What Data Gets Synced?

Once connected, AccessFuel will sync the following data from your Klaviyo account:

Essential Data

Profiles: Customer profiles, contact information, and custom properties
Campaigns: Email campaign details, status, and performance
Flows: Automated flow configurations and trigger conditions
Metrics: Email engagement metrics (opens, clicks, conversions)
Lists: Email list memberships and subscription status

Additional Data

Campaigns Detailed: Extended campaign performance data including A/B tests
Lists Detailed: Comprehensive list data with growth metrics
Events: Customer behavior events and interactions
Segments: Dynamic segment definitions and membership

Data Refresh Schedule

Frequency: Data syncs every 24 hours
Historical Data: All data from your specified start date (or all available history)
Incremental Updates: Only new and updated records are synced after the initial load
Real-time Updates: Not available; data reflects the previous day's activity

Features Enabled

Connecting Klaviyo unlocks these AccessFuel features:

Lifecycle Health Analysis: Track customer engagement across email touchpoints
Customer Churn Predictions: AI-powered predictions of likely churners
Campaign Performance Tracking: Analyze email campaign effectiveness
Email & SMS Consent Breakdown: Monitor subscription and consent trends
Customer Segmentation: Create targeted segments based on email behavior
Attribution Analysis: Understand email's impact on revenue

Troubleshooting

Common Issues

Invalid API Key

If your API key is invalid:

Verify you copied the entire key without spaces or line breaks
Ensure the key starts with pk_
Check that the key hasn't been revoked in your Klaviyo settings
Generate a new API key if needed

Missing Permissions

If certain data isn't syncing:

Go to your Klaviyo API Keys settings
Check that all required scopes are enabled:
- Profiles (Read)
- Lists (Read)
- Campaigns (Read)
- Flows (Read)
- Metrics (Read)
- Events (Read)
If scopes are missing, create a new API key with correct permissions

API Key Revoked

If your API key was revoked:

Create a new Private API Key in Klaviyo
Ensure all required scopes are selected
Update the key in Settings > Integrations

Data Not Syncing

Check the following:

Verify your API key is correct and starts with pk_
Ensure the API key hasn't been revoked
Confirm all required API scopes are enabled
Check that your Klaviyo account is active

Rate Limiting

If you're experiencing rate limit errors:

This is rare but can happen with very large accounts
Contact support to adjust sync frequency
We'll work with you to optimize the data sync schedule

API Key Management

Best Practices

Name Your Keys: Use descriptive names like "AccessFuel Production"
Regular Rotation: Rotate API keys every 6-12 months for security
Minimal Scopes: Only grant the scopes listed above
Monitor Usage: Check your Klaviyo API usage regularly
Revoke Unused Keys: Remove keys that are no longer needed

Rotating Your API Key

To rotate your API key:

Create a new Private API Key in Klaviyo with the same scopes
Update the key in Settings > Integrations
Wait for confirmation that the new key is active
Revoke the old key in your Klaviyo settings

Security & Privacy

API Key Storage: Keys are encrypted and stored securely with AES-256 encryption
Data Transmission: All data is transmitted over HTTPS with TLS 1.3
Access Control: Only authorized AccessFuel team members can access your credentials
Compliance: We comply with GDPR, CCPA, and email marketing regulations
Data Retention: Data is retained according to your organization's settings
No Email Sending: AccessFuel only reads data; we never send emails through your account