---
title: ''
description: Telegraf plugin for collecting metrics from Mailchimp
url: https://docs.influxdata.com/telegraf/v1/input-plugins/mailchimp/
estimated_tokens: 858
product: Telegraf Enterprise
version: v1
publisher: InfluxData
canonical: https://docs.influxdata.com/telegraf/v1/input-plugins/mailchimp/
date: '2026-05-21T20:10:18+02:00'
lastmod: '2026-05-21T20:10:18+02:00'
---

==========

* Telegraf v0.2.4+

[Plugin source](https://github.com/influxdata/telegraf/tree/v1.39.1/plugins/inputs/mailchimp/)[Download configuration](https://raw.githubusercontent.com/influxdata/telegraf/refs/tags/v1.39.1/plugins/inputs/mailchimp/sample.conf)

# Mailchimp Input Plugin

This plugin gathers metrics from the [Mailchimp](https://mailchimp.com) service using the[Mailchimp API](https://developer.mailchimp.com/).

**Introduced in:** Telegraf v0.2.4**Tags:** cloud, web**OS support:** all

## Global configuration options

Plugins support additional global and plugin configuration settings for tasks
such as modifying metrics, tags, and fields, creating aliases, and configuring
plugin ordering. See [CONFIGURATION.md](/telegraf/v1/configuration/#plugins) for more details.

## Configuration

```toml
# Gathers metrics from the /3.0/reports MailChimp API
[[inputs.mailchimp]]
  ## MailChimp API key
  ## get from https://admin.mailchimp.com/account/api/
  api_key = "" # required

  ## Reports for campaigns sent more than days_old ago will not be collected.
  ## 0 means collect all and is the default value.
  days_old = 0

  ## Campaign ID to get, if empty gets all campaigns, this option overrides days_old
  # campaign_id = ""
```

## Metrics

* mailchimp
  * tags:
    * id
    * campaign\_title

  * fields:
    * emails\_sent (integer, emails)
    * abuse\_reports (integer, reports)
    * unsubscribed (integer, unsubscribes)
    * hard\_bounces (integer, emails)
    * soft\_bounces (integer, emails)
    * syntax\_errors (integer, errors)
    * forwards\_count (integer, emails)
    * forwards\_opens (integer, emails)
    * opens\_total (integer, emails)
    * unique\_opens (integer, emails)
    * open\_rate (double, percentage)
    * clicks\_total (integer, clicks)
    * unique\_clicks (integer, clicks)
    * unique\_subscriber\_clicks (integer, clicks)
    * click\_rate (double, percentage)
    * facebook\_recipient\_likes (integer, likes)
    * facebook\_unique\_likes (integer, likes)
    * facebook\_likes (integer, likes)
    * industry\_type (string, type)
    * industry\_open\_rate (double, percentage)
    * industry\_click\_rate (double, percentage)
    * industry\_bounce\_rate (double, percentage)
    * industry\_unopen\_rate (double, percentage)
    * industry\_unsub\_rate (double, percentage)
    * industry\_abuse\_rate (double, percentage)
    * list\_stats\_sub\_rate (double, percentage)
    * list\_stats\_unsub\_rate (double, percentage)
    * list\_stats\_open\_rate (double, percentage)
    * list\_stats\_click\_rate (double, percentage)

## Example Output

```text
mailchimp,campaign_title=Freddie's\ Jokes\ Vol.\ 1,id=42694e9e57 abuse_reports=0i,click_rate=42,clicks_total=42i,emails_sent=200i,facebook_likes=42i,facebook_recipient_likes=5i,facebook_unique_likes=8i,forwards_count=0i,forwards_opens=0i,hard_bounces=0i,industry_abuse_rate=0.00021111996110887,industry_bounce_rate=0.0063767751251474,industry_click_rate=0.027431311866951,industry_open_rate=0.17076777144396,industry_type="Social Networks and Online Communities",industry_unopen_rate=0.82285545343089,industry_unsub_rate=0.001436957032815,list_stats_click_rate=42,list_stats_open_rate=42,list_stats_sub_rate=10,list_stats_unsub_rate=20,open_rate=42,opens_total=186i,soft_bounces=2i,syntax_errors=0i,unique_clicks=400i,unique_opens=100i,unique_subscriber_clicks=42i,unsubscribed=2i 1741188555526302348
```