# Medusa Customer Groups API

**Canonical:** https://apis.io/apis/medusa/medusa-customer-groups-api/  
**Provider:** Medusa — https://apis.io/providers/medusa/  
**Base URL:** https://{medusa-backend-domain}  
**Documentation:** https://docs.medusajs.com/api/store

Medusa Customer Groups API is one of 82 APIs that [Medusa](https://apis.io/providers/medusa/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Customer Groups. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

Customers can be organized into groups. These groups are useful for segregation and marketing purposes. For example, you can provide different prices for specific customers by creating a price list conditioned to their group. These API routes allow admin users to manage groups and the customers in them.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| GET | `/admin/customer-groups` | List Customer Groups |
| POST | `/admin/customer-groups` | Create Customer Group |
| GET | `/admin/customer-groups/{id}` | Get a Customer Group |
| POST | `/admin/customer-groups/{id}` | Update a Customer Group |
| DELETE | `/admin/customer-groups/{id}` | Delete a Customer Group |
| POST | `/admin/customer-groups/{id}/customers` | Manage Customers of a Customer Group |

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/medusa/refs/heads/main/openapi/medusa-customer-groups-api-openapi.yml
- **Documentation** — https://docs.medusajs.com/api/store
- **APIReference** — https://docs.medusajs.com/api/store
- **OpenAPI Source** — https://raw.githubusercontent.com/medusajs/medusa/develop/www/apps/api-reference/specs/store/openapi.full.yaml
- **Authentication** — https://docs.medusajs.com/api/store#authentication
- **Documentation** — https://docs.medusajs.com/api/admin
- **APIReference** — https://docs.medusajs.com/api/admin
- **OpenAPI Source** — https://raw.githubusercontent.com/medusajs/medusa/develop/www/apps/api-reference/specs/admin/openapi.full.yaml
- **Authentication** — https://docs.medusajs.com/api/admin#authentication

## Other Medusa APIs (12)

- [Medusa GraphQL API](https://apis.io/apis/medusa/medusa-graphql-api/)
- [Medusa MCP Remote Server](https://apis.io/apis/medusa/medusa-mcp-server/)
- [Medusa Api Keys API](https://apis.io/apis/medusa/medusa-api-keys-api/)
- [Medusa Auth API](https://apis.io/apis/medusa/medusa-auth-api/)
- [Medusa [auth Provider] API](https://apis.io/apis/medusa/medusa-auth-provider-api/)
- [Medusa Campaigns API](https://apis.io/apis/medusa/medusa-campaigns-api/)
- [Medusa Carts API](https://apis.io/apis/medusa/medusa-carts-api/)
- [Medusa Claims API](https://apis.io/apis/medusa/medusa-claims-api/)
- [Medusa Collections API](https://apis.io/apis/medusa/medusa-collections-api/)
- [Medusa Currencies API](https://apis.io/apis/medusa/medusa-currencies-api/)
- [Medusa Customers API](https://apis.io/apis/medusa/medusa-customers-api/)
- [Medusa Draft Orders API](https://apis.io/apis/medusa/medusa-draft-orders-api/)

## Tags

Customer Groups

---

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