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"
      ]
    }
  ]
}
Example: "Emails Sent" in October, compared to September.

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_sent
  • Unsubscribes

    Total number of recipientes that clicked the "Unsubscribe" link through all of your campaigns in the analysed period.

    mailchimp:unsubscribed
  • Total Clicks

    The number of recipients who clicked any tracked link any number of times.

    mailchimp:clicks_total
  • Click Rate

    The number of total clicks divided by the number of emails sent.

    mailchimp:clicks_total_rate
  • Unique Clicks

    Number of unique recipients that clicked any tracked link.

    mailchimp:unique_clicks
  • Total Openings

    The number of recipients who opened your emails any number of times.

    mailchimp:opens_total
  • Open Rate

    The number of total openings divided by the number of emails sent.

    mailchimp:opens_total_rate
  • Unique Openings

    The number of unique recipients that opened your emails.

    mailchimp:unique_opens
  • Number of Campaigns

    Number of campaigns that sent emails in the time period analysed.

    mailchimp:campaigns_count
  • Soft Bounces

    Soft bounces typically indicate a temporary delivery issue.

    mailchimp:soft_bounces
  • Hard Bounces

    A hard bounce indicates a permanent reason an email cannot be delivered.

    mailchimp:hard_bounces
  • Total 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_count
  • Forward 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:timeseries
  • Openings 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_campaigns
  • E-commerce Statistics by Campaign

    E-commerce statistical data of the campaigns of the analyzed period.

    mailchimp:ecommerce_summary
  • Lists 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.