Klaviyo

This connector captures data from Klaviyo into Estuary collections.

Supported data resources

The following data resources are supported through the Klaviyo API:

• Campaigns
• Coupon Codes
• Coupons
• Flows
• Forms
• Events
• Images
• Lists
• Metrics
• Profiles
• Push Tokens
• Segments
• Tag Groups
• Tags
• Templates

By default, each resource is mapped to an Estuary collection through a separate binding.

Prerequisites

To set up the Klaviyo source connector, you'll need a Klaviyo Private API key.

Configuration

You configure connectors either in the Estuary web app, or by directly editing the catalog specification files. See connectors to learn more about using connectors. The values and specification sample below provide configuration details specific to the Klaviyo source connector.

Properties

Endpoint

Property	Title	Description	Type	Required/Default
/start_date	Start Date	The date from which you'd like to replicate data for Klaviyo API, in the format YYYY-MM-DDT00:00:00Z. All data generated after this date will be replicated.	string	30 days before the present
/credentials	Credentials	Credentials for the service	object
/credentials/credentials_title	Authentication Method	Set to API Key.	string	Required
/credentials/access_token	API Key	The value of your Klaviyo private API Key.	string	Required
/advanced/window_size	Window Size	Date window size for the events backfill in ISO 8601 format. ex: P30D means 30 days, PT6H means 6 hours. If you have a significant amount of events data to backfill, smaller window sizes will allow the connector to checkpoint its progress more frequently.	string	PT1H

Bindings

Property	Title	Description	Type	Required/Default
/name	Data resource	Name of the data resource.	string	Required
/interval	Interval	Interval between data syncs	string	5M

Sample

captures:
  ${PREFIX}/${CAPTURE_NAME}:
    endpoint:
      connector:
        image: ghcr.io/estuary/source-klaviyo-native:v1
        config:
            advanced:
              window_size: PT2H
            credentials:
              credentials: API Key
              access_token: <secret>
            start_date: "2025-08-14T00:00:00Z"
    bindings:
      - resource:
          name: events
        target: ${PREFIX}/events