# Mailchimp Segments API

**Canonical:** https://apis.io/apis/mailchimp/mailchimp-segments-api/  
**Provider:** Mailchimp — https://apis.io/providers/mailchimp/  
**Base URL:** https://api.mailchimp.com  
**Documentation:** https://mailchimp.com/developer/open-commerce/

Mailchimp Segments API is one of 54 APIs that [Mailchimp](https://apis.io/providers/mailchimp/) publishes on the [APIs.io](https://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 segments. 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.

The segments API from Mailchimp — 6 operation(s) for segments.

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| GET | `/3.0/segments` | List Segments |
| POST | `/3.0/segments` | Add Segment |
| DELETE | `/3.0/segments/{segment_id}` | Delete Segment |
| GET | `/3.0/segments/{segment_id}` | Get Segment |
| PATCH | `/3.0/segments/{segment_id}` | Update Segment |
| POST | `/3.0/segments/{segment_id}/snapshots` | Snapshot a Segment |
| GET | `/3.0/segments/{segment_id}/snapshots/{snapshot_id}` | Get Segment Snapshot |
| GET | `/3.0/segments/{segment_id}/snapshots/{snapshot_id}/members` | Get Snapshot Member Contact IDs |
| GET | `/3.0/segments/{segment_id}/count` | Get Segment Member Count |

## Machine-readable artifacts (23)

- **OpenAPI** — https://artifacts.apis.io/mailchimp/openapi/mailchimp-segments-api-openapi.yml
- **Documentation** — https://mailchimp.com/developer/marketing/docs/fundamentals/
- **AsyncAPI** — https://artifacts.apis.io/mailchimp/asyncapi/mailchimp-marketing-webhooks-asyncapi.yml
- **JSONSchema** — https://artifacts.apis.io/mailchimp/json-schema/campaign.json
- **JSONSchema** — https://artifacts.apis.io/mailchimp/json-schema/audience.json
- **JSONSchema** — https://artifacts.apis.io/mailchimp/json-schema/member.json
- **JSONSchema** — https://artifacts.apis.io/mailchimp/json-schema/template.json
- **JSONLD** — https://artifacts.apis.io/mailchimp/json-ld/context.jsonld
- **Integrations** — https://mailchimp.com/developer/marketing/docs/integrations/
- **ErrorCodes** — https://mailchimp.com/developer/marketing/docs/errors/
- **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/
- **E-Commerce** — https://mailchimp.com/developer/marketing/docs/e-commerce/
- **Methods and Parameters** — https://mailchimp.com/developer/marketing/docs/methods-parameters/
- **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/
- **Webhooks** — https://mailchimp.com/developer/transactional/docs/webhooks/
- **APIReference** — https://mailchimp.com/developer/transactional/api/
- **GettingStarted** — https://mailchimp.com/developer/transactional/guides/send-first-email/
- **Outbound Email** — https://mailchimp.com/developer/transactional/docs/outbound-email/
- **Tags and Metadata** — https://mailchimp.com/developer/transactional/docs/tags-metadata/

## Other Mailchimp APIs (12)

- [Mailchimp Open Commerce](https://apis.io/apis/mailchimp/mailchimp-open-commerce/)
- [Mailchimp Automations API](https://apis.io/apis/mailchimp/mailchimp-automations-api/)
- [Mailchimp Batches API](https://apis.io/apis/mailchimp/mailchimp-batches-api/)
- [Mailchimp Campaigns API](https://apis.io/apis/mailchimp/mailchimp-campaigns-api/)
- [Mailchimp Conversations API](https://apis.io/apis/mailchimp/mailchimp-conversations-api/)
- [Mailchimp Ecommerce API](https://apis.io/apis/mailchimp/mailchimp-ecommerce-api/)
- [Mailchimp Exports API](https://apis.io/apis/mailchimp/mailchimp-exports-api/)
- [Mailchimp Lists API](https://apis.io/apis/mailchimp/mailchimp-lists-api/)
- [Mailchimp Messages API](https://apis.io/apis/mailchimp/mailchimp-messages-api/)
- [Mailchimp Metadata API](https://apis.io/apis/mailchimp/mailchimp-metadata-api/)
- [Mailchimp Rejects API](https://apis.io/apis/mailchimp/mailchimp-rejects-api/)
- [Mailchimp Reporting API](https://apis.io/apis/mailchimp/mailchimp-reporting-api/)

## Tags

segments

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/mailchimp/mailchimp-segments-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/mailchimp/.