Mailchimp

Mailchimp Lists API

The Lists API from Mailchimp — 11 operation(s) for lists.

GitHub OpenAPI

Operations 70

GET /lists Get lists info #
POST /lists Add list #
GET /lists/{list_id} Get list info #
PATCH /lists/{list_id} Update lists #
DELETE /lists/{list_id} Delete list #
POST /lists/{list_id} Batch subscribe or unsubscribe #
GET /lists/{list_id}/abuse-reports List abuse reports #
GET /lists/{list_id}/abuse-reports/{report_id} Get abuse report #
GET /lists/{list_id}/activity List recent activity #
GET /lists/{list_id}/clients List top email clients #
GET /lists/{list_id}/growth-history List growth history data #
GET /lists/{list_id}/growth-history/{month} Get growth history by month #
GET /lists/{list_id}/interest-categories List interest categories #
POST /lists/{list_id}/interest-categories Add interest category #
GET /lists/{list_id}/interest-categories/{interest_category_id} Get interest category info #
PATCH /lists/{list_id}/interest-categories/{interest_category_id} Update interest category #
DELETE /lists/{list_id}/interest-categories/{interest_category_id} Delete interest category #
GET /lists/{list_id}/interest-categories/{interest_category_id}/interests List interests in category #
POST /lists/{list_id}/interest-categories/{interest_category_id}/interests Add interest in category #
GET /lists/{list_id}/interest-categories/{interest_category_id}/interests/{interest_id} Get interest in category #
PATCH /lists/{list_id}/interest-categories/{interest_category_id}/interests/{interest_id} Update interest in category #
DELETE /lists/{list_id}/interest-categories/{interest_category_id}/interests/{interest_id} Delete interest in category #
GET /lists/{list_id}/segments List segments #
POST /lists/{list_id}/segments Add segment #
GET /lists/{list_id}/segments/{segment_id} Get segment info #
DELETE /lists/{list_id}/segments/{segment_id} Delete segment #
PATCH /lists/{list_id}/segments/{segment_id} Update segment #
POST /lists/{list_id}/segments/{segment_id} Batch add or remove members #
GET /lists/{list_id}/segments/{segment_id}/members List members in segment #
POST /lists/{list_id}/segments/{segment_id}/members Add member to segment #
DELETE /lists/{list_id}/segments/{segment_id}/members/{subscriber_hash} Remove list member from segment #
GET /lists/{list_id}/tag-search Search for tags on a list by name #
GET /lists/{list_id}/members List members info #
POST /lists/{list_id}/members Add member to list #
GET /lists/{list_id}/members/{subscriber_hash} Get member info #
PUT /lists/{list_id}/members/{subscriber_hash} Add or update list member #
PATCH /lists/{list_id}/members/{subscriber_hash} Update list member #
DELETE /lists/{list_id}/members/{subscriber_hash} Archive list member #
GET /lists/{list_id}/members/{subscriber_hash}/activity View recent activity 50 #
GET /lists/{list_id}/members/{subscriber_hash}/activity-feed View recent activity #
GET /lists/{list_id}/members/{subscriber_hash}/tags List member tags #
POST /lists/{list_id}/members/{subscriber_hash}/tags Add or remove member tags #
GET /lists/{list_id}/members/{subscriber_hash}/events List member events #
POST /lists/{list_id}/members/{subscriber_hash}/events Add event #
GET /lists/{list_id}/members/{subscriber_hash}/goals List member goal events #
GET /lists/{list_id}/members/{subscriber_hash}/notes List recent member notes #
POST /lists/{list_id}/members/{subscriber_hash}/notes Add member note #
GET /lists/{list_id}/members/{subscriber_hash}/notes/{note_id} Get member note #
PATCH /lists/{list_id}/members/{subscriber_hash}/notes/{note_id} Update note #
DELETE /lists/{list_id}/members/{subscriber_hash}/notes/{note_id} Delete note #
POST /lists/{list_id}/members/{subscriber_hash}/actions/delete-permanent Delete list member #
GET /lists/{list_id}/merge-fields List merge fields #
POST /lists/{list_id}/merge-fields Add merge field #
GET /lists/{list_id}/merge-fields/{merge_id} Get merge field #
PATCH /lists/{list_id}/merge-fields/{merge_id} Update merge field #
DELETE /lists/{list_id}/merge-fields/{merge_id} Delete merge field #
GET /lists/{list_id}/webhooks List webhooks #
POST /lists/{list_id}/webhooks Add webhook #
GET /lists/{list_id}/webhooks/{webhook_id} Get webhook info #
DELETE /lists/{list_id}/webhooks/{webhook_id} Delete webhook #
PATCH /lists/{list_id}/webhooks/{webhook_id} Update webhook #
GET /lists/{list_id}/signup-forms List signup forms #
POST /lists/{list_id}/signup-forms Customize signup form #
GET /lists/{list_id}/locations List locations #
GET /lists/{list_id}/surveys Get information about all surveys for a list #
POST /lists/{list_id}/surveys Create survey #
GET /lists/{list_id}/surveys/{survey_id} Get survey #
PATCH /lists/{list_id}/surveys/{survey_id} Update survey #
DELETE /lists/{list_id}/surveys/{survey_id} Delete survey #
POST /lists/{list_id}/surveys/{survey_id}/actions/replicate Replicate survey #

Documentation

📖
Documentation
https://mailchimp.com/developer/marketing/docs/fundamentals/
📖
APIReference
https://mailchimp.com/developer/marketing/api/
📖
GettingStarted
https://mailchimp.com/developer/marketing/guides/quick-start/
📖
Authentication
https://mailchimp.com/developer/marketing/guides/access-user-data-oauth-2/
📖
Documentation
https://mailchimp.com/developer/transactional/docs/fundamentals/
📖
GettingStarted
https://mailchimp.com/developer/transactional/guides/quick-start/
📖
Authentication
https://mailchimp.com/developer/transactional/docs/authentication-delivery/
📖
APIReference
https://mailchimp.com/developer/transactional/api/
📖
GettingStarted
https://mailchimp.com/developer/transactional/guides/send-first-email/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/mailchimp/refs/heads/main/openapi/mailchimp-lists-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/mailchimp/refs/heads/main/asyncapi/mailchimp-marketing-webhooks-asyncapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/mailchimp/refs/heads/main/json-schema/campaign.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/mailchimp/refs/heads/main/json-schema/audience.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/mailchimp/refs/heads/main/json-schema/member.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/mailchimp/refs/heads/main/json-schema/template.json

Other Resources

🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/mailchimp/refs/heads/main/json-ld/context.jsonld
🔗
Integrations
https://mailchimp.com/developer/marketing/docs/integrations/
🔗
ErrorCodes
https://mailchimp.com/developer/marketing/docs/errors/
🔗
E-Commerce
https://mailchimp.com/developer/marketing/docs/e-commerce/
🔗
Methods and Parameters
https://mailchimp.com/developer/marketing/docs/methods-parameters/
🔗
Webhooks
https://mailchimp.com/developer/transactional/docs/webhooks/
🔗
Outbound Email
https://mailchimp.com/developer/transactional/docs/outbound-email/
🔗
Tags and Metadata
https://mailchimp.com/developer/transactional/docs/tags-metadata/

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/mailchimp-lists-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mailchimp-lists-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 3.0.91
  title: Mailchimp Marketing Lists API
  contact:
    name: Mailchimp API Support
    email: apihelp@mailchimp.com
  x-permalink: https://github.com/mailchimp/mailchimp-client-lib-codegen/blob/main/spec/marketing.json
servers:
- url: https://server.api.mailchimp.com/3.0
security:
- basicAuth: []
tags:


# --- truncated at 32 KB (2226 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mailchimp/refs/heads/main/openapi/mailchimp-lists-api-openapi.yml