> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://mailchimp.com/developer/marketing/api/lists/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://mailchimp.com/developer/_mcp/server.

# Lists

> Find all the Mailchimp API documentation and tools developers need to send marketing and transactional emails.


## API Docs

- Lists [Get lists info](https://mailchimp.com/developer/marketing/api/lists/list.md)
- Lists [Add list](https://mailchimp.com/developer/marketing/api/lists/create.md)
- Lists [Get list info](https://mailchimp.com/developer/marketing/api/lists/get.md)
- Lists [Update lists](https://mailchimp.com/developer/marketing/api/lists/update.md)
- Lists [Batch subscribe or unsubscribe](https://mailchimp.com/developer/marketing/api/lists/batch-subscribe-or-unsubscribe.md)
- Lists [Delete list](https://mailchimp.com/developer/marketing/api/lists/delete.md)
- Lists [List recent activity](https://mailchimp.com/developer/marketing/api/lists/list-activity.md)
- Lists [List top email clients](https://mailchimp.com/developer/marketing/api/lists/list-clients.md)
- Lists [List growth history data](https://mailchimp.com/developer/marketing/api/lists/list-growth-history.md)
- Lists [Get growth history by month](https://mailchimp.com/developer/marketing/api/lists/get-growth-history.md)
- Lists [List locations](https://mailchimp.com/developer/marketing/api/lists/list-locations.md)
- Lists [Search for tags on a list by name.](https://mailchimp.com/developer/marketing/api/lists/list-tag-search.md)
- Lists [List signup forms](https://mailchimp.com/developer/marketing/api/lists/list-signup-forms.md)
- Lists [Customize signup form](https://mailchimp.com/developer/marketing/api/lists/create-signup-form.md)
- Abuse reports [List abuse reports](https://mailchimp.com/developer/marketing/api/lists/abuse-reports/list-abuse-reports.md)
- Abuse reports [Get abuse report](https://mailchimp.com/developer/marketing/api/lists/abuse-reports/get-abuse-report.md)
- Interest categories [List interest categories](https://mailchimp.com/developer/marketing/api/lists/interest-categories/list-interest-categories.md)
- Interest categories [Add interest category](https://mailchimp.com/developer/marketing/api/lists/interest-categories/create-interest-category.md)
- Interest categories [Get interest category info](https://mailchimp.com/developer/marketing/api/lists/interest-categories/get-interest-category.md)
- Interest categories [Update interest category](https://mailchimp.com/developer/marketing/api/lists/interest-categories/update-interest-category.md)
- Interest categories [Delete interest category](https://mailchimp.com/developer/marketing/api/lists/interest-categories/delete-interest-category.md)
- Interest categories [List interests in category](https://mailchimp.com/developer/marketing/api/lists/interest-categories/list-interest-category-interests.md)
- Interest categories [Add interest in category](https://mailchimp.com/developer/marketing/api/lists/interest-categories/create-interest-category-interest.md)
- Interest categories [Get interest in category](https://mailchimp.com/developer/marketing/api/lists/interest-categories/get-interest-category-interest.md)
- Interest categories [Update interest in category](https://mailchimp.com/developer/marketing/api/lists/interest-categories/update-interest-category-interest.md)
- Interest categories [Delete interest in category](https://mailchimp.com/developer/marketing/api/lists/interest-categories/delete-interest-category-interest.md)
- Members [List members info](https://mailchimp.com/developer/marketing/api/lists/members/list-members.md)
- Members [Add member to list](https://mailchimp.com/developer/marketing/api/lists/members/create-member.md)
- Members [Get member info](https://mailchimp.com/developer/marketing/api/lists/members/get-member.md)
- Members [Update list member](https://mailchimp.com/developer/marketing/api/lists/members/update-member.md)
- Members [Add or update list member](https://mailchimp.com/developer/marketing/api/lists/members/upsert-member.md)
- Members [Archive list member](https://mailchimp.com/developer/marketing/api/lists/members/delete-member.md)
- Members [Delete list member](https://mailchimp.com/developer/marketing/api/lists/members/create-member-action-delete-permanent.md)
- Members [View recent activity 50](https://mailchimp.com/developer/marketing/api/lists/members/list-member-activity.md)
- Members [View recent activity](https://mailchimp.com/developer/marketing/api/lists/members/list-member-activity-feed.md)
- Members [List member events](https://mailchimp.com/developer/marketing/api/lists/members/list-member-events.md)
- Members [Add event](https://mailchimp.com/developer/marketing/api/lists/members/create-member-event.md)
- Members [List member goal events](https://mailchimp.com/developer/marketing/api/lists/members/list-member-goals.md)
- Members [List recent member notes](https://mailchimp.com/developer/marketing/api/lists/members/list-member-notes.md)
- Members [Add member note](https://mailchimp.com/developer/marketing/api/lists/members/create-member-note.md)
- Members [Get member note](https://mailchimp.com/developer/marketing/api/lists/members/get-member-note.md)
- Members [Update note](https://mailchimp.com/developer/marketing/api/lists/members/update-member-note.md)
- Members [Delete note](https://mailchimp.com/developer/marketing/api/lists/members/delete-member-note.md)
- Members [List member tags](https://mailchimp.com/developer/marketing/api/lists/members/list-member-tags.md)
- Members [Add or remove member tags](https://mailchimp.com/developer/marketing/api/lists/members/create-member-tag.md)
- Merge fields [List merge fields](https://mailchimp.com/developer/marketing/api/lists/merge-fields/list-merge-fields.md)
- Merge fields [Add merge field](https://mailchimp.com/developer/marketing/api/lists/merge-fields/create-merge-field.md)
- Merge fields [Get merge field](https://mailchimp.com/developer/marketing/api/lists/merge-fields/get-merge-field.md)
- Merge fields [Update merge field](https://mailchimp.com/developer/marketing/api/lists/merge-fields/update-merge-field.md)
- Merge fields [Delete merge field](https://mailchimp.com/developer/marketing/api/lists/merge-fields/delete-merge-field.md)
- Segments [List segments](https://mailchimp.com/developer/marketing/api/lists/segments/list-segments.md)
- Segments [Add segment](https://mailchimp.com/developer/marketing/api/lists/segments/create-segment.md)
- Segments [Get segment info](https://mailchimp.com/developer/marketing/api/lists/segments/get-segment.md)
- Segments [Update segment](https://mailchimp.com/developer/marketing/api/lists/segments/update-segment.md)
- Segments [Batch add or remove members](https://mailchimp.com/developer/marketing/api/lists/segments/batch-add-or-remove-members.md)
- Segments [Delete segment](https://mailchimp.com/developer/marketing/api/lists/segments/delete-segment.md)
- Segments [List members in segment](https://mailchimp.com/developer/marketing/api/lists/segments/list-segment-members.md)
- Segments [Add member to segment](https://mailchimp.com/developer/marketing/api/lists/segments/create-segment-member.md)
- Segments [Remove list member from segment](https://mailchimp.com/developer/marketing/api/lists/segments/delete-segment-member.md)
- Surveys [Get information about all surveys for a list](https://mailchimp.com/developer/marketing/api/lists/surveys/list-surveys.md)
- Surveys [Create survey](https://mailchimp.com/developer/marketing/api/lists/surveys/create-survey.md)
- Surveys [Get survey](https://mailchimp.com/developer/marketing/api/lists/surveys/get-survey.md)
- Surveys [Update survey](https://mailchimp.com/developer/marketing/api/lists/surveys/update-survey.md)
- Surveys [Delete survey](https://mailchimp.com/developer/marketing/api/lists/surveys/delete-survey.md)
- Surveys [Create a Survey Campaign](https://mailchimp.com/developer/marketing/api/lists/surveys/create-list-survey-action-create-email.md)
- Surveys [Publish a Survey](https://mailchimp.com/developer/marketing/api/lists/surveys/create-list-survey-action-publish.md)
- Surveys [Replicate survey](https://mailchimp.com/developer/marketing/api/lists/surveys/create-list-survey-action-replicate.md)
- Surveys [Unpublish a Survey](https://mailchimp.com/developer/marketing/api/lists/surveys/create-list-survey-action-unpublish.md)
- Webhooks [List webhooks](https://mailchimp.com/developer/marketing/api/lists/webhooks/list-webhooks.md)
- Webhooks [Add webhook](https://mailchimp.com/developer/marketing/api/lists/webhooks/create-webhook.md)
- Webhooks [Get webhook info](https://mailchimp.com/developer/marketing/api/lists/webhooks/get-webhook.md)
- Webhooks [Update webhook](https://mailchimp.com/developer/marketing/api/lists/webhooks/update-webhook.md)
- Webhooks [Delete webhook](https://mailchimp.com/developer/marketing/api/lists/webhooks/delete-webhook.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://mailchimp.com/developer/marketing/api/lists/openapi.json)
- [OpenAPI YAML](https://mailchimp.com/developer/marketing/api/lists/openapi.yaml)