LogoLogo
  • 🦩Overview
  • 💾Datasets
    • Overview
    • Core Concepts
      • Columns & Annotations
      • Type & Property Mappings
      • Relationships
    • Basic Datasets
      • dbt Integration
      • Sigma Integration
      • Looker Integration
    • SaaS Datasets
    • CSV Datasets
    • Streaming Datasets
    • Entity Resolution
    • AI Columns
      • AI Prompts Recipe Book
    • Enrichment Columns
      • Quick Start
      • HTTP Request Enrichments
    • Computed Columns
    • Version Control
  • 📫Syncs
    • Overview
    • Triggering & Scheduling
    • Retry Handling
    • Live Syncs
    • Audience Syncs
    • Observability
      • Current Sync Run Overview
      • Sync History
      • Sync Tracking
      • API Inspector
      • Sync Alerts
      • Observability Lake
      • Datadog Integration
      • Warehouse Writeback
      • Sync Lifecycle Webhooks
      • Sync Dry Runs
    • Structuring Data
      • Liquid Templates
      • Event Syncs
      • Arrays and Nested Objects
  • 👥Audience Hub
    • Overview
    • Creating Segments
      • Segment Priorities
      • Warehouse-Managed Audiences
    • Experiments and Analysis
      • Audience Match Rates
    • Activating Segments
    • Calculated Columns
    • Data Preparation
      • Profile Explorer
      • Exclusion Lists
  • 🧮Data Sources
    • Overview
    • Available Sources
      • Amazon Athena
      • Amazon Redshift
      • Amazon S3
      • Azure Synapse
      • ClickHouse
      • Confluent Cloud
      • Databricks
      • Elasticsearch
      • Kafka
      • Google AlloyDB
      • Google BigQuery
      • Google Cloud SQL for PostgreSQL
      • Google Pub/Sub
      • Google Sheets
      • Greenplum
      • HTTP Request
      • HubSpot
      • Materialize
      • Microsoft Fabric
      • MotherDuck
      • MySQL
      • PostgreSQL
      • Rockset
      • Salesforce
      • SingleStore
      • Snowflake
      • SQL Server
      • Trino
  • 🛫Destinations
    • Overview
    • Available Destinations
      • Accredible
      • ActiveCampaign
      • Adobe Target
      • Aha
      • Airship
      • Airtable
      • Algolia
      • Amazon Ads DSP (AMC)
      • Amazon DynamoDB
      • Amazon EventBridge
      • Amazon Pinpoint
      • Amazon Redshift
      • Amazon S3
      • Amplitude
      • Anaplan
      • Antavo
      • Appcues
      • Apollo
      • Asana
      • AskNicely
      • Attentive
      • Attio
      • Autopilot Journeys
      • Azure Blob Storage
      • Box
      • Bloomreach
      • Blackhawk
      • Braze
      • Brevo (formerly Sendinblue)
      • Campaign Monitor
      • Canny
      • Channable
      • Chargebee
      • Chargify
      • ChartMogul
      • ChatGPT Retrieval Plugin
      • Chattermill
      • ChurnZero
      • CJ Affiliate
      • CleverTap
      • ClickUp
      • Constant Contact
      • Courier
      • Criteo
      • Crowd.dev
      • Customer.io
      • Databricks
      • Delighted
      • Discord
      • Drift
      • Drip
      • Eagle Eye
      • Emarsys
      • Enterpret
      • Elasticsearch
      • Facebook Ads
      • Facebook Product Catalog
      • Freshdesk
      • Freshsales
      • Front
      • FullStory
      • Gainsight
      • GitHub
      • GitLab
      • Gladly
      • Google Ads
        • Customer Match Lists (Audiences)
        • Offline Conversions
      • Google AlloyDB
      • Google Analytics 4
      • Google BigQuery
      • Google Campaign Manager 360
      • Google Cloud Storage
      • Google Datastore
      • Google Display & Video 360
      • Google Drive
      • Google Search Ads 360
      • Google Sheets
      • Heap.io
      • Help Scout
      • HTTP Request
      • HubSpot
      • Impact
      • Insider
      • Insightly
      • Intercom
      • Iterable
      • Jira
      • Kafka
      • Kevel
      • Klaviyo
      • Kustomer
      • Labelbox
      • LaunchDarkly
      • LinkedIn
      • LiveIntent
      • Loops
      • Mailchimp
      • Mailchimp Transactional (Mandrill)
      • Mailgun
      • Marketo
      • Meilisearch
      • Microsoft Advertising
      • Microsoft Dynamics
      • Microsoft SQL Server
      • Microsoft Teams
      • Mixpanel
      • MoEngage
      • Mongo DB
      • mParticle
      • MySQL
      • NetSuite
      • Notion
      • OneSignal
      • Optimizely
      • Oracle Database
      • Oracle Eloqua
      • Oracle Fusion
      • Oracle Responsys
      • Orbit
      • Ortto
      • Outreach
      • Pardot
      • Partnerstack
      • Pendo
      • Pinterest
      • Pipedrive
      • Planhat
      • PostgreSQL
      • PostHog
      • Postscript
      • Productboard
      • Qualtrics
      • Radar
      • Reddit Ads
      • Rokt
      • RollWorks
      • Sailthru
      • Salesforce
      • Salesforce Commerce Cloud
      • Salesforce Marketing Cloud
      • Salesloft
      • Segment
      • SendGrid
      • Sense
      • SFTP
      • Shopify
      • Singular
      • Slack
      • Snapchat
      • Snowflake
      • Split
      • Sprig
      • Stripe
      • The Trade Desk
      • TikTok
      • Totango
      • Userflow
      • Userpilot
      • Vero Cloud
      • Vitally
      • Webhooks
      • Webflow
      • X Ads (formerly Twitter Ads)
      • Yahoo Ads (DSP)
      • Zendesk
      • Zoho CRM
      • Zuora
    • Custom & Partner Destinations
  • 📎Misc
    • Credits
    • Census Embedded
    • Data Storage
      • Census Store
        • Query Census Store from Snowflake
      • General Object Storage
      • Bring Your Own Bucket
        • Bring your own S3 Bucket
        • Bring your own GCS Bucket
        • Bring your own Azure Bucket
    • Developers
      • GitLink
      • Dataset API
      • Custom Destination API
      • Management API
    • Security & Privacy
      • Login & SSO Settings
      • Workspaces
      • Role-based Access Controls
      • Network Access Controls
      • SIEM Log Forwarding
      • Secure Storage of Customer Credentials
      • Digital Markets Act (DMA) Consent for Ad Platforms
    • Health and Usage Reporting
      • Workspace Homepage
      • Product Usage Dashboard
      • Observability Toolkit
      • Alerts
    • FAQs
Powered by GitBook
On this page
  • Getting Started
  • Supported Objects and Sync Behaviors
  • How profile identifiers work in Klaviyo
  • Klaviyo Events
  • Need help connecting to Klaviyo?

Was this helpful?

  1. Destinations
  2. Available Destinations

Klaviyo

This page describes how to use Census with Klaviyo.

PreviousKevelNextKustomer

Last updated 2 months ago

Was this helpful?

Klaviyo is a customer data and marketing platform specializing in marketing for Retail, Ecommerce and D2C businesses. It's a powerful, scalable, and secure platform for sending emails, SMS, and more.

Getting Started

As always, the first step is connecting Census to your Klaviyo account.

Census requires two API keys, both a Public and Private key, in order to provide full functionality. To access your API Keys,

  1. Within Klaviyo, click your organization name in the bottom left.

  2. Navigate to Settings and click API keys from the submenu.

We'll cover how to create both below, and provides additional details as well.

1. Private API Key

The Private API Key is used to sync most data to Klaviyo. We recommend creating a new API Key specifically for Census.

Census requires "Full Access" in order to write data to Klaviyo. However, you may use Klaviyo's "Custom Access" Private API Key to limit the access to only the necessary permissions.

2. Public API Key / Site ID

The Public API Key is used solely to access the that powers Profile Update or Create at higher volume.

Klaviyo only allows a single Site ID so in this case, you can reuse your existing public API Key.

3. Configuring Census

Once you've collected both keys, you can create a new Klaviyo destination in Census.

  1. Click New Destination and select Klaviyo from the dropdown list.

  2. Paste in your Klaviyo Private and Public Keys and click Save.

You should now be ready to create a new sync to Klaviyo from Census!

Supported Objects and Sync Behaviors

Object Name

Supported?

Sync Keys

Behavior

Profile

✅

External ID (recommended), Email, Phone Number

Update or Create, Update Only, Delete

✅

External ID (recommended), Email, Phone Number

Mirror

✅

Unique Event ID

Send

How profile identifiers work in Klaviyo

Though Census supports selecting a primary key for profile syncs, it's important to know that Klaviyo has a specific way of handling profile identifiers that Census cannot override.

Klaviyo supports four identifiers for profiles: Email, Phone Number, External ID, and Klaviyo ID.

Klaviyo will always use Klaviyo ID as the primary identifier for profiles when available (only for Update Only syncs). This is the only key that Klaviyo will use to allow updating other identifiers like Email or Phone Number on existing profiles.

When upserting profiles, Klaviyo ID cannot be used but any combination of the other three identifiers can be used as the primary key. However, Klaviyo will verify that the provided identifiers are unique and reference the same profile.

For example: If you are syncing a profile with an External ID and Email, Klaviyo will check if the External ID and Email are associated with the same profile.

  • If a profile with a matching External ID and Email is found, Klaviyo will update the profile with the provided data.

  • If a profile with a matching External ID is found but the provided email is different (and not already used by another profile), Klaviyo will update the profile with the provided email.

  • If a profile with a matching External ID is found, and a different profile with a matching email is found, Klaviyo will throw an error indicating a conflict in the provided data.

Though the API prevents them, duplicate profiles are still possible in Klaviyo. Upserting data when duplicates are present will result in only one of the duplicates being updated (by closest match). We recommend cleaning up duplicates in Klaviyo to avoid confusion caused by updates that appear to be missing.

Klaviyo Events

Klaviyo events work like most behavioral event destinations. They require a unique event ID which is used to prevent duplicate events from being created in Klaviyo, as well as a name, timestamp, and custom properties.

Need help connecting to Klaviyo?

Within Census, navigate to .

Profile & List

Event

Learn more about all of our sync behaviors in our documentation. if you want Census to support more Klaviyo objects and/or behaviors.

One quirk of events in Klaviyo is how events are associated with specific users. Klaviyo will associate events with a user based on the email address provided, the Klaviyo User ID, or an external ID. Due to this Klaviyo event syncs require at least an email address, Klaviyo ID, or external ID to be captured properly. Using in some cases depending on how Klaviyo is configured.

You can send our at support@getcensus.com or start a conversation from the in-app chat.

🛫
Klaviyo's Help Center
Klaviyo API
Destinations
Syncs
Contact us
phone numbers as identifiers does not work reliably
support team an email
Audience Sync
Event Sync