Klaviyo Integration

​

Setup

1. Go to Project Settings → Project Integrations
2. Select Klaviyo from the list
3. Enter your credentials:
   • Private API Key - Your Klaviyo Private API Key
     • Get it from Klaviyo API Keys
4. Test the connection
5. Start using Klaviyo in your prompts

​

How It Works

​

API Endpoints

• /api/profiles/ - Manage customer profiles
• /api/lists/ - Manage email lists
• /api/campaigns/ - Manage campaigns
• /api/events/ - Track events
• /api/metrics/ - Access metrics

​

Common Operations

​

List Profiles

• GET /api/profiles/ - List customer profiles
• Supports query parameters: page[size], page[cursor], filter, sort, fields

​

Create Profiles

• POST /api/profiles/ - Create a new customer profile

​

Update Profiles

• PATCH /api/profiles/{profile_id}/ - Update a profile

​

List Lists

• GET /api/lists/ - List email lists

​

Create Lists

• POST /api/lists/ - Create a new email list

​

Query Parameters

• page[size] - Number of items per page
• page[cursor] - Cursor for pagination
• filter - Filter results (e.g., equals(email,[email protected]))
• sort - Sort results (e.g., created_at)
• fields - Specify which fields to return (comma-separated or array)

​

Example Usage

​

Display Profiles

Show all profiles from Klaviyo. Display email, first name, 
last name, and subscription status.

​

Create a Profile

Create a new profile in Klaviyo with email "[email protected]", 
first name "John", and last name "Doe".

​

Search Profiles

Find all profiles in Klaviyo where the email contains "example.com".

​

Update a Profile

Update the Klaviyo profile for "[email protected]" to set 
their subscription status to "subscribed".

​

Manage Lists

Show all email lists in Klaviyo and display the number of 
subscribers in each list.

​

Best Practices

• Specify fields - Tell Leo which fields to display or update
• Use filters - Describe what profiles you want to find
• Mention the integration - Always say “from Klaviyo” or “to Klaviyo” so Leo knows which integration to use
• Use pagination - For large datasets, specify page size

​

Troubleshooting

​

Connection Issues

• Check API key - Verify your Private API Key is correct
• Key permissions - Ensure your API key has the necessary permissions
• API revision - The integration uses Klaviyo API revision 2024-10-15

​

Data Not Showing

• Check endpoint - Verify you’re using the correct API endpoint
• Permissions - Ensure your API key has read access
• Filter syntax - Review your filter criteria

​

Can’t Create/Update

• Write permissions - Ensure your API key has write access
• Required fields - Check that all required fields are provided
• Data format - Verify data matches Klaviyo’s expected format