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"
]
}
]
}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:recipientsDelivered
Number of emails successfully delivered to recipients' inboxes in the analyzed period.
klaviyo:deliveredDelivery rate
Percentage of sent emails that were successfully delivered. Calculated as delivered divided by recipients.
klaviyo:delivery_rateUnique opens
Number of unique recipients who opened at least one email campaign in the analyzed period.
klaviyo:opens_uniqueOpen rate
Percentage of delivered emails that were opened by at least one unique recipient.
klaviyo:open_rateUnique clicks
Number of unique recipients who clicked at least one link in any email campaign in the analyzed period.
klaviyo:clicks_uniqueClick rate
Percentage of delivered emails that received at least one unique click.
klaviyo:click_rateClick-to-open rate
Percentage of opened emails that also received a unique click. Indicates email content relevance.
klaviyo:click_to_open_rateUnsubscribes
Total number of recipients who unsubscribed from email campaigns in the analyzed period.
klaviyo:unsubscribesUnsubscribe rate
Percentage of recipients who unsubscribed from email campaigns relative to total recipients.
klaviyo:unsubscribe_rateBounced
Total number of emails that could not be delivered (hard + soft bounces) in the analyzed period.
klaviyo:bouncedSpam complaints
Number of recipients who marked a campaign email as spam in the analyzed period.
klaviyo:spam_complaintsConversion revenue
Total revenue attributed to email campaigns through tracked conversions in the analyzed period.
klaviyo:conversion_valueRevenue 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_timeDelivery vs bounces
Line chart showing the volume of delivered emails versus bounced emails per campaign in the analyzed period.
klaviyo:delivery_vs_bouncesFlow 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_campaignsTop flows
Performance breakdown of all automation flows active in the analyzed period.
klaviyo:top_flowsForm 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.
