Mailchimp API

Varies by plan (check documentation)

72 B

Metadata Score Metadata estimate · not endpoint-tested

Visit Official Site Compare Alternatives

Overview

Mailchimp API lets you manage email lists, create campaigns, and track subscriber activity. Use it to sync contacts from your app and automate email marketing workflows.

Beginner Tip

Your API key encodes your data center — the suffix after the dash (e.g. "us6") must match the subdomain in your base URL: https://us6.api.mailchimp.com. Using the wrong server is the most common connection error.

Available Data

email delivery status

message ID

bounce/complaint data

open/click tracking

stock price and symbol

open/close/high/low values

Example Response

JSON Response

{
  "message_id": "msg_abc123def456",
  "status": "delivered",
  "to": "user@example.com",
  "subject": "Welcome!",
  "timestamp": "2025-01-15T10:30:00Z"
}

Field Reference

lists Array of audience (list) objects in your Mailchimp account.

lists[].id The unique string ID for this audience — used in all member and campaign endpoints.

lists[].name Human-readable name of the audience.

lists[].stats.member_count Number of active, subscribed contacts in the audience.

lists[].stats.campaign_count Total number of campaigns sent to this audience.

total_items Total number of lists in your account, regardless of the count parameter.

Implementation Example

Request

const url = "https://mailchimp.com/developer/";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

401 API Key Invalid Incorrect API key or wrong data center subdomain in the base URL

✓ Go to Mailchimp Account > Extras > API Keys, copy the key, and match its server suffix (e.g. us6) to your base URL.

400 Member Exists Trying to add an email that is already subscribed to the list

✓ Use PUT /lists/{list_id}/members/{subscriber_hash} to update an existing member instead of POST.

404 Resource Not Found The list ID or campaign ID in the URL is incorrect

✓ Fetch your list IDs first with GET /3.0/lists to confirm the correct ID before constructing other requests.

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

How is this scored? →