Klaviyo

LiveAPI Key

Marketing

Connect Klaviyo to ClearView to automatically create profiles and trigger email and SMS campaigns when companies visit your site. ClearView identifies the visiting company and pushes rich profile data and custom events into Klaviyo, enabling highly targeted marketing flows.

What Gets Synced

Klaviyo profiles

Created with email, company name, and domain

Custom events

Company Identified, Hot Lead, and Returning Visitor events

Profile properties

Industry, lead score, page views, and visit history

List membership

Optionally add profiles to a specific Klaviyo list

Supported Events

EventTriggerAction
company.identifiedA new company is identifiedCreate profile, track "Company Identified" event
lead.hotA lead reaches hot score thresholdTrack "Hot Lead" event on profile
visitor.returningA known company returns to your siteTrack "Returning Visitor" event on profile

Prerequisites

  • A Klaviyo account (Free plan or higher)
  • Owner or Admin role in your Klaviyo account
  • A Private API Key with full access scope
  • ClearView tracking script installed on your site

Setup Guide

1

Log in to Klaviyo

Go to klaviyo.com and sign in to your account with admin credentials.

2

Navigate to API Keys

Click on Settings (gear icon) in the bottom-left corner, then select Account, then API Keys.

Path: Settings > Account > API Keys
3

Create a Private API Key

Click "Create Private API Key". Give it a descriptive name like "ClearView Integration" and grant it Full Access scope. Click Create and copy the key.

Key format

Klaviyo private keys start with pk_ followed by a long alphanumeric string. Make sure you copy the full key.
4

Find your List ID (optional)

If you want new profiles added to a specific list, go to Audience > Lists & Segments, click on your target list, and copy the List ID from the URL or list settings. This step is optional; if omitted, profiles will be created without list assignment.

5

Configure in ClearView

In your ClearView dashboard, go to Settings > Integrations. Find Klaviyo and click Connect. Paste your API key and optionally the List ID.

Required Fields

API Keypk_xxxxxxxxxxxxxxxxxxxxxxxx
List ID (optional)AbCdEf
6

Test the connection

Click the "Test" button to verify. ClearView will attempt to authenticate with Klaviyo and confirm the integration is working.

Data Mapping

ClearView FieldKlaviyo FieldExample
Company email$emailinfo@acmecorp.com
Company name$organizationAcme Corp
DomainCustom property domainacmecorp.com
Lead scoreCustom property clearview_lead_score85
IndustryCustom property industrySaaS

Example Output

When a company is identified, ClearView creates a Klaviyo profile and tracks a custom event:

Klaviyo Profile + Event
json
{
"data": {
"type": "profile",
"attributes": {
"email": "info@acmecorp.com",
"organization": "Acme Corp",
"properties": {
"domain": "acmecorp.com",
"clearview_lead_score": 85,
"industry": "SaaS",
"source": "clearview",
"first_seen": "2025-01-15T10:30:00Z",
"page_views": 12
}
}
}
}
// Custom event tracked on the profile:
{
"data": {
"type": "event",
"attributes": {
"metric": { "name": "Company Identified" },
"profile": { "email": "info@acmecorp.com" },
"properties": {
"company": "Acme Corp",
"domain": "acmecorp.com",
"lead_score": 85
}
}
}
}

Troubleshooting

"Invalid API Key" error

Make sure you are using a Private API Key (starts with pk_), not a Public API Key (starts with Qx7vBn). Public keys do not have write access.

Profiles not added to list

If you specified a List ID, verify it is correct. Go to Audience > Lists & Segments in Klaviyo and confirm the list exists. The List ID is visible in the URL when viewing the list.

Events not appearing in flows

Custom events created by ClearView (Company Identified, Hot Lead, Returning Visitor) appear under Analytics > Metrics in Klaviyo. Make sure your flow triggers are set to use the correct metric name.

Need help?

If you are having trouble setting up the Klaviyo integration, our team is here to help.