Metrics
Mailchimp metrics via API
Your customer connects their Mailchimp account and your product queries 18 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": "mailchimp:emails_sent",
"component": "number_v1",
"metrics": [
"emails_sent"
]
}
]
}More Mailchimp 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
Performance by Hour
The number of clicks and opened emails, grouped by the hour that it happened.
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": "mailchimp:timeseries",
"component": "chart_v1",
"metrics": [
"unique_opens",
"recipients_clicks"
],
"dimensions": [
"timeseries"
]
}
]
}Table
Top Campaigns
Your best campaigns of 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": "mailchimp:top_campaigns",
"component": "datatable_v1",
"metrics": [
"emails_sent",
"opens.unique_opens",
"opens.open_rate",
"clicks.unique_clicks",
"clicks.click_rate",
"bounces.soft_bounces",
"bounces.hard_bounces"
],
"dimensions": [
"campaign_title"
]
}
]
}Number
Unsubscribes
Total number of recipientes that clicked the "Unsubscribe" link through all of your campaigns in the analysed 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": "mailchimp:unsubscribed",
"component": "number_v1",
"metrics": [
"unsubscribed"
]
}
]
}Numbers
13 metrics
Emails Sent
Number of emails that were sent by the campaigns in the time period analysed.
mailchimp:emails_sentUnsubscribes
Total number of recipientes that clicked the "Unsubscribe" link through all of your campaigns in the analysed period.
mailchimp:unsubscribedTotal Clicks
The number of recipients who clicked any tracked link any number of times.
mailchimp:clicks_totalClick Rate
The number of total clicks divided by the number of emails sent.
mailchimp:clicks_total_rateUnique Clicks
Number of unique recipients that clicked any tracked link.
mailchimp:unique_clicksTotal Openings
The number of recipients who opened your emails any number of times.
mailchimp:opens_totalOpen Rate
The number of total openings divided by the number of emails sent.
mailchimp:opens_total_rateUnique Openings
The number of unique recipients that opened your emails.
mailchimp:unique_opensNumber of Campaigns
Number of campaigns that sent emails in the time period analysed.
mailchimp:campaigns_countSoft Bounces
Soft bounces typically indicate a temporary delivery issue.
mailchimp:soft_bouncesHard Bounces
A hard bounce indicates a permanent reason an email cannot be delivered.
mailchimp:hard_bouncesTotal Forwards
The number of times the campaign was forwarded using the "Forward to a Friend" form. This stat considers forwards only through the "Forward to a Friend" form and is not able to detect when a recipient uses the forwarding function in their email program.
mailchimp:forwards_countForward Openings
The number of times the campaign was opened by someone who was forwarded the campaign using a "Forward to a Friend" form.
mailchimp:forwards_opens
Charts
2 metrics
Performance by Hour
The number of clicks and opened emails, grouped by the hour that it happened.
mailchimp:timeseriesOpenings by Day
This graph shows your campaigns' openings, grouped by the day it happened.
mailchimp:opens_by_day
Tables
3 metrics
Top Campaigns
Your best campaigns of the analyzed period.
mailchimp:top_campaignsE-commerce Statistics by Campaign
E-commerce statistical data of the campaigns of the analyzed period.
mailchimp:ecommerce_summaryLists Summary
Statistics of your sender lists.
mailchimp:lists
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
