1. Help Center
  2. Data Source Guides

Guide: Using Klaviyo with Databox


How to connect Klaviyo to Databox


How to connect Klaviyo to Databox

To connect a Klaviyo Account in Databox, go to  Data Sources > + New connection. Type Klaviyo in the search bar and click on the green Connect button. 

This will open the Activation window, which is where you will be prompted to enter your Klaviyo API Key. You can find your API Key in Klaviyo by navigating to Account > Settings > API Keys and click Create API Key.

All required scopes must be selected when you add your API key. Learn more here

Screenshot 2024-03-26 at 10.16.58 PM

Klaviyo supports dozens of integrations, such as Amazon Marketplace, DonorPerfect, and Typeform. You can access data from these integrated platforms using the Metric Builder for Klaviyo. Learn more here

What Klaviyo permissions do you need to connect to Databox?

klaviyo-api key-2

All required scopes must be selected when you add your API key. Minimal requirement is READ access for all categories. This can be easily achieved by selecting Read-Only Key radio button when creating an API Key in Klaviyo UI.

When connecting Klaviyo with Databox an error will instantly appear if you don't have “Accounts” Read Access selected.

Learn how to manage your Accounts API Keys here.

For more information on Klaviyo's API overview, learn more here.

How much historical data is synced when you first connect Klaviyo to Databox?

When you connect a new Klaviyo Data Source in Databox, 3 years worth of historical data is initially synced. 

Certain Metrics may have more or less historical data available. For more information about the amount of historical data available for a specific Metric, please contact our Support Team at help@databox.com.

Pro Tip: Once your Klaviyo Data Source is connected and actively syncing data, we store the data that's collected in our own database. This allows us to accumulate more data over time as more data syncs are made so that you can report on more historical Klaviyo data in your Databox reports. Learn more here

What time zone does Klaviyo data sync in? 

Klaviyo data is synced in the time zone set in the Klaviyo Account. The Timezone is automatically retrieved from your Klaviyo profile once your Klaviyo account is connected to Databox.

For example, if your Klaviyo Account time zone is set as EST, your Klaviyo data will sync with Databox in EST.

How to access pre-built Klaviyo Templates

  1. Navigate to Databoards > Public Templates
  2. In the Data Source drop-down list, select Klaviyo
  3. To view a preview of the Template populated with dummy data, click Preview
  4. To pull the Template into your Account and re-populate it with your own Klaviyo data, click Use Template
  5. Select the appropriate Klaviyo Data Source from the drop-down list to complete the process. The Databoard will be re-populated with data from the selected Klaviyo Account and can be found on the Databoards page

Pro Tip: Once the Databoard is available on the Databoards page, it is completely disconnected from the public Template. Therefore, you can further customize this Databoard to meet your specific needs using the Designer.

Popular Klaviyo Template

Klaviyo (email performance)

Screenshot 2024-03-26 at 4.30.33 PM

This Klaviyo dashboard template provides you with insights about your email open and click rates, subscribers growth, and email performance to grow your business - all in one place.

How to build a Databoard using Klaviyo data

  1. Navigate to Databoards > + New Databoard > Start Blank
  2. Click on the Metric Library icon on the left-hand side of the Designer.
  3. Select the appropriate Klaviyo Account from the Data Source drop-down list in the Metric Library
  4. View the list of pre-built Klaviyo Datablocks in the Metric Library. Click on the Metric or drag and drop your selected Datablock onto your Databoard.    
  5. If a pre-built Datablock isn't available for your use case, navigate to the Visualization Types above the Metric Library
  6. View the list of Visualizations available in Databox. Click on the Visualization or drag and drop the selected Datablock to your Databoard.
  7. Click on the Datablock on the Databoard to open the corresponding Datablock Editor on the right-hand side of the Designer.
  8. In the Metrics drop-down, click Data Source to select the appropriate Data Source. This will filter out metrics from the specific Data Source.
  9. In the main Metrics drop-down, select the metric you'd like to display on the Datablock, using the Search bar if needed. This will update the Datablock, and it will populate with the corresponding data. 
  10. Complete steps 4-9 until your Databoard is complete.

Popular Klaviyo Metrics

Received Emails Opened Emails Clicked Emails

Bounced Emails Dropped Emails New Members Subscribed to Lists

View a full list of Klaviyo Metrics available in Databox here.

How to use the Metric Builder for Klaviyo

The Metric Builder for Klaviyo allows you to create Custom Metrics based on emails, products, and more. 

Learn more about the Metric Builder for Klaviyo here

Additional Information


  • Granularity Restrictions
  • API Limitations

Granularity Restrictions

  • Due to API limitations, Quarterly, Yearly and All time granularity is not supported. This may affect visualization options for Charts in Databox.

    For example, if a Klaviyo Metric is used on a Line or Bar Chart with Yearly Date Range selected, Quarterly data won't be displayed on the Chart.
    However, the big number above the Chart will accurately reflect the Metric value for the selected Date Range.

    Learn more about Granularity here
  • Rate Limits:
    • Metrics (pagination):

        • Burst: 10/s

        • Steady: 150/m

    • Metric-aggregates (per metric):

      • Burst: 3/s

      • Steady: 60/m

    • Lists & segments (pagination):

      • Burst: 75/s

      • Steady: 700/m

    • Members (per list/segment):

      • Burst: 1/s

      • Steady: 15/m

    • Learn more about Klaviyo's Rate Limits here
  • Pagination is used for getting the list of metrics a user has available in Klaviyo.