# Mailchimp Marketing API

**Provider:** Mailchimp
**Category:** communication
**Base URL:** `https://{server}.api.mailchimp.com/3.0`
**Auth:** basic — `Authorization: Basic base64(anystring:YOUR_API_KEY)`
**Rate Limit:** 10 concurrent connections · No per-minute limit
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://mailchimp.com/developer/marketing/api/

## Description

The Mailchimp Marketing API provides full programmatic control over your email marketing. Manage subscriber lists (audiences) and tags, create and send campaigns, build automation journeys, run A/B tests, pull campaign reports (opens, clicks, revenue), sync e-commerce purchase data, and manage templates. The API follows RESTful conventions with OAuth 2.0 for multi-account apps or API keys for single-account integrations.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://{server}.api.mailchimp.com/3.0/lists` | List all audiences (subscriber lists) |
| POST | `https://{server}.api.mailchimp.com/3.0/lists/{list_id}/members` | Add a subscriber to an audience |
| GET | `https://{server}.api.mailchimp.com/3.0/campaigns` | List email campaigns with status filter |
| POST | `https://{server}.api.mailchimp.com/3.0/campaigns` | Create a new email campaign |
| POST | `https://{server}.api.mailchimp.com/3.0/campaigns/{campaign_id}/actions/send` | Send a campaign to its audience |
| GET | `https://{server}.api.mailchimp.com/3.0/reports/{campaign_id}` | Get campaign performance report |

## Authentication

Use HTTP Basic Auth with any string as username and your API key as password. Your server prefix (e.g., us1) is in the API key and determines your base URL.

```
Authorization: Basic base64(anystring:YOUR_API_KEY)
```

## Sample Request

```bash
curl "https://us1.api.mailchimp.com/3.0/lists" \
  -u "anystring:$MAILCHIMP_API_KEY"
```

## Sample Response

```json
{
  "lists": [{
    "id": "abc1234def",
    "name": "Main Subscribers",
    "stats": {
      "member_count": 4821,
      "avg_open_rate": 0.28,
      "avg_click_rate": 0.045
    },
    "date_created": "2022-01-15T10:00:00+00:00"
  }],
  "total_items": 3
}
```

## Pricing Details

Free: 500 contacts, 1k sends/mo. Essentials: $13/mo (500 contacts). Standard: $20/mo. Premium: $350/mo (150k contacts).

---

*Source: [API Map](https://apimap.dev/apis/mailchimp/) — CC BY 4.0*