How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Mailchimp

Mailchimp Lists API

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

Documentation Provider Profile APIs.io OpenAPI GitHub

Mailchimp Lists API is one of 120 APIs that Mailchimp publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

This API exposes 4 JSON Schema definitions.

Tagged areas include List. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, a JSON-LD context, an API reference, a getting-started guide, and 4 JSON Schemas.

This API exposes 26 operations across 11 paths. It is described by OpenAPI 2.0, at version 3.0.55.

Requests are made against the base URL https://server.api.mailchimp.com/3.0.

26 operations 11 paths 0 schemas 7 DELETE9 GET6 PATCH3 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
3.0.55
Base URL
https://server.api.mailchimp.com/3.0
Authentication
basic
Contact
Mailchimp API Support
Resource Areas
1

Authentication & Security 1

Mailchimp Lists API declares 1 security scheme for authenticating requests. It defines a basic scheme (basicAuth). By default, every request must be authenticated.

Paths & Operations 26

Across 11 paths, the API surfaces 26 operations — 7 DELETE, 9 GET, 6 PATCH, 3 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Lists 26
GET
/lists
Mailchimp Get Lists Info
getLists 13 params → 200default
POST
/lists
Mailchimp Add List
postLists 1 param → 200default
GET
/lists/{list_id}/abuse-reports/{report_id}
Mailchimp Get Abuse Report
getListsIdAbuseReportsId 6 params → 200default
GET
/lists/{list_id}/interest-categories/{interest_category_id}
Mailchimp Get Interest Category Info
getListsIdInterestCategoriesId 4 params → 200default
PATCH
/lists/{list_id}/interest-categories/{interest_category_id}
Mailchimp Update Interest Category
patchListsIdInterestCategoriesId 3 params → 200default
DELETE
/lists/{list_id}/interest-categories/{interest_category_id}
Mailchimp Delete Interest Category
deleteListsIdInterestCategoriesId 2 params → 204default
GET
/lists/{list_id}/interest-categories/{interest_category_id}/interests/{interest_id}
Mailchimp Get Interest in Category
getListsIdInterestCategoriesIdInterestsId 5 params → 200default
PATCH
/lists/{list_id}/interest-categories/{interest_category_id}/interests/{interest_id}
Mailchimp Update Interest in Category
patchListsIdInterestCategoriesIdInterestsId 4 params → 200default
DELETE
/lists/{list_id}/interest-categories/{interest_category_id}/interests/{interest_id}
Mailchimp Delete Interest in Category
deleteListsIdInterestCategoriesIdInterestsId 3 params → 204default
GET
/lists/{list_id}/segments/{segment_id}
Mailchimp Get Segment Info
getListsIdSegmentsId 7 params → 200default
DELETE
/lists/{list_id}/segments/{segment_id}
Mailchimp Delete Segment
deleteListsIdSegmentsId 2 params → 204default
PATCH
/lists/{list_id}/segments/{segment_id}
Mailchimp Update Segment
patchListsIdSegmentsId 3 params → 200default
POST
/lists/{list_id}/segments/{segment_id}
Mailchimp Batch Add or Remove Members
postListsIdSegmentsId 3 params → 200default
DELETE
/lists/{list_id}/segments/{segment_id}/members/{subscriber_hash}
Mailchimp Remove List Member From Segment
deleteListsIdSegmentsIdMembersId 3 params → 204default
GET
/lists/{list_id}/members/{subscriber_hash}
Mailchimp Get Member Info
getListsIdMembersId 4 params → 200default
PUT
/lists/{list_id}/members/{subscriber_hash}
Mailchimp Add or Update List Member
putListsIdMembersId 4 params → 200default
PATCH
/lists/{list_id}/members/{subscriber_hash}
Mailchimp Update List Member
patchListsIdMembersId 4 params → 200default
DELETE
/lists/{list_id}/members/{subscriber_hash}
Mailchimp Archive List Member
deleteListsIdMembersId 2 params → 204default
GET
/lists/{list_id}/members/{subscriber_hash}/notes/{note_id}
Mailchimp Get Member Note
getListsIdMembersIdNotesId 5 params → 200default
PATCH
/lists/{list_id}/members/{subscriber_hash}/notes/{note_id}
Mailchimp Update Note
patchListsIdMembersIdNotesId 4 params → 200default
DELETE
/lists/{list_id}/members/{subscriber_hash}/notes/{note_id}
Mailchimp Delete Note
deleteListsIdMembersIdNotesId 3 params → 204default
POST
/lists/{list_id}/members/{subscriber_hash}/actions/delete-permanent
Mailchimp Delete List Member
postListsIdMembersHashActionsDeletePermanent 2 params → 204default
GET
/lists/{list_id}/merge-fields/{merge_id}
Mailchimp Get Merge Field
getListsIdMergeFieldsId 4 params → 200default
PATCH
/lists/{list_id}/merge-fields/{merge_id}
Mailchimp Update Merge Field
patchListsIdMergeFieldsId 3 params → 200default
DELETE
/lists/{list_id}/merge-fields/{merge_id}
Mailchimp Delete Merge Field
deleteListsIdMergeFieldsId 2 params → 204default
GET
/lists/{list_id}/surveys/{survey_id}
Mailchimp Get Survey
getListsIdSurveysId 2 params → 200default

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

mailchimp-lists-api-openapi.yml Raw ↑

Other APIs Mailchimp publishes across the network.

Mailchimp Open Commerce
AE Profile APIs.io
Mailchimp Abuse API
AE Profile APIs.io
Mailchimp Account Export API
AE Profile APIs.io
Mailchimp Accounts API
AE Profile APIs.io
Mailchimp Actions API
AE Profile APIs.io
Mailchimp Activity API
AE Profile APIs.io
Mailchimp Advice API
AE Profile APIs.io
Mailchimp Allowlists API
AE Profile APIs.io
Mailchimp Answers API
AE Profile APIs.io
Mailchimp Applications API
AE Profile APIs.io
Mailchimp Archive API
AE Profile APIs.io
Mailchimp Authorized API
AE Profile APIs.io
#List
← Back to M APIs
API Details
ID
mailchimp:mailchimp-lists-api
Base URL
https://server.api.mailchimp.com/3.0
Docs
https://mailchimp.com/developer/marketing/
Provider
Mailchimp
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=mailchimp-lists-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/mailchimp-lists-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

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

Where this information came from

This is an independent, third-party profile of Mailchimp Lists API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.