# Medusa Customers API

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

Medusa Customers 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 Customers. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

Customers can either be created when they register through the Store APIs, or created by the admin using the Admin APIs. These API routes allow admin users to manage customers in their store.

## Operations (19)

| Method | Path | Summary |
|---|---|---|
| GET | `/admin/customers` | List Customers |
| POST | `/admin/customers` | Create Customer |
| GET | `/admin/customers/{id}` | Get a Customer |
| POST | `/admin/customers/{id}` | Update a Customer |
| DELETE | `/admin/customers/{id}` | Delete a Customer |
| GET | `/admin/customers/{id}/addresses` | List Addresses |
| POST | `/admin/customers/{id}/addresses` | Add a Customer Address |
| GET | `/admin/customers/{id}/addresses/{address_id}` | List Addresses |
| POST | `/admin/customers/{id}/addresses/{address_id}` | Update a Customer's Address |
| DELETE | `/admin/customers/{id}/addresses/{address_id}` | Remove an Address from Customer |
| POST | `/admin/customers/{id}/customer-groups` | Manage Customer Groups of Customer |
| POST | `/store/customers` | Register Customer |
| GET | `/store/customers/me` | Get Logged-in Customer |
| POST | `/store/customers/me` | Update Customer |
| GET | `/store/customers/me/addresses` | List Customer's Addresses |
| POST | `/store/customers/me/addresses` | Create Address for Logged-In Customer |
| GET | `/store/customers/me/addresses/{address_id}` | Get Customer's Address |
| POST | `/store/customers/me/addresses/{address_id}` | Update Customer's Address |
| DELETE | `/store/customers/me/addresses/{address_id}` | Remove Customer's Address |

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/medusa/refs/heads/main/openapi/medusa-customers-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 Customer Groups API](https://apis.io/apis/medusa/medusa-customer-groups-api/)
- [Medusa Draft Orders API](https://apis.io/apis/medusa/medusa-draft-orders-api/)

## Tags

Customers

---

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