Metrics

Klaviyo metrics via API

Your customer connects their Klaviyo account and your product queries 20 metrics through the same endpoint as every other platform. Each metric has an id (reference_key) that goes in the request.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "comparison_start": "2026-09-01",
  "comparison_end": "2026-09-30",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "klaviyo:recipients",
      "component": "number_v1",
      "metrics": [
        "recipients"
      ],
      "dimensions": [
        "campaign"
      ]
    }
  ]
}
Example: "Recipients" in October, compared to September.

More Klaviyo request examples

The same endpoint for every kind of metric. The metrics and dimensions of each item come from the platform catalog (GET /api/metrics/{integration_slug}).

Chart

Campaign engagement over time

Bar chart comparing unique opens and unique clicks per campaign in the analyzed period.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "klaviyo:campaign_engagement_over_time",
      "component": "chart_v1",
      "metrics": [
        "opens_unique",
        "clicks_unique"
      ],
      "dimensions": [
        "date"
      ]
    }
  ]
}

Table

Top campaigns

Performance breakdown of all email campaigns sent in the analyzed period.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "klaviyo:top_campaigns",
      "component": "datatable_v1",
      "metrics": [
        "campaign",
        "recipients",
        "opens_unique",
        "open_rate",
        "clicks_unique",
        "click_rate",
        "bounced"
      ],
      "dimensions": [
        "campaign"
      ]
    }
  ]
}

Number

Delivered

Number of emails successfully delivered to recipients' inboxes in the analyzed period.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "klaviyo:delivered",
      "component": "number_v1",
      "metrics": [
        "delivered"
      ],
      "dimensions": [
        "campaign"
      ]
    }
  ]
}

Numbers

14 metrics

  • Recipients

    Total number of recipients targeted across all email campaigns in the analyzed period.

    klaviyo:recipients
  • Delivered

    Number of emails successfully delivered to recipients' inboxes in the analyzed period.

    klaviyo:delivered
  • Delivery rate

    Percentage of sent emails that were successfully delivered. Calculated as delivered divided by recipients.

    klaviyo:delivery_rate
  • Unique opens

    Number of unique recipients who opened at least one email campaign in the analyzed period.

    klaviyo:opens_unique
  • Open rate

    Percentage of delivered emails that were opened by at least one unique recipient.

    klaviyo:open_rate
  • Unique clicks

    Number of unique recipients who clicked at least one link in any email campaign in the analyzed period.

    klaviyo:clicks_unique
  • Click rate

    Percentage of delivered emails that received at least one unique click.

    klaviyo:click_rate
  • Click-to-open rate

    Percentage of opened emails that also received a unique click. Indicates email content relevance.

    klaviyo:click_to_open_rate
  • Unsubscribes

    Total number of recipients who unsubscribed from email campaigns in the analyzed period.

    klaviyo:unsubscribes
  • Unsubscribe rate

    Percentage of recipients who unsubscribed from email campaigns relative to total recipients.

    klaviyo:unsubscribe_rate
  • Bounced

    Total number of emails that could not be delivered (hard + soft bounces) in the analyzed period.

    klaviyo:bounced
  • Spam complaints

    Number of recipients who marked a campaign email as spam in the analyzed period.

    klaviyo:spam_complaints
  • Conversion revenue

    Total revenue attributed to email campaigns through tracked conversions in the analyzed period.

    klaviyo:conversion_value
  • Revenue per recipient

    Average revenue generated per email recipient, calculated as total conversion revenue divided by recipients.

    klaviyo:revenue_per_recipient

Charts

3 metrics

  • Campaign engagement over time

    Bar chart comparing unique opens and unique clicks per campaign in the analyzed period.

    klaviyo:campaign_engagement_over_time
  • Delivery vs bounces

    Line chart showing the volume of delivered emails versus bounced emails per campaign in the analyzed period.

    klaviyo:delivery_vs_bounces
  • Flow engagement over time

    Line chart comparing unique opens and unique clicks per automation flow in the analyzed period.

    klaviyo:flow_engagement_over_time

Tables

3 metrics

  • Top campaigns

    Performance breakdown of all email campaigns sent in the analyzed period.

    klaviyo:top_campaigns
  • Top flows

    Performance breakdown of all automation flows active in the analyzed period.

    klaviyo:top_flows
  • Form performance

    Submission funnel for all Klaviyo signup forms, showing views, unique views, submissions and submit rate.

    klaviyo:form_performance

See Connect applied to your product.

Try it for 15 days with no card, or walk our team through your use case.