# makeup.land Customers API

**Canonical:** https://apis.io/apis/makeup-land/makeup-land-customers-api/  
**Provider:** makeup.land — https://apis.io/providers/makeup-land/  
**Base URL:** https://makeup.land/api/v1  
**Documentation:** https://makeup.land/llms-full.txt

makeup.land Customers API is one of 11 APIs that [makeup.land](https://apis.io/providers/makeup-land/) 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, a getting-started guide, authentication docs, and rate-limit docs.

Customer CRUD + tags + opportunities + best deals

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/customers` | Look up a customer by phone or email |
| POST | `/api/v1/customers` | Create or update a customer (bulk-import friendly) |
| PATCH | `/api/v1/customers/{id}/tags` | Add / remove / replace tags on a customer |
| GET | `/api/v1/customers/{id}/opportunities` | Open M-Club opportunities + referral metadata for a customer |
| GET | `/api/v1/customers/best-deals` | Personalised best-deal candidates for a customer |

## Machine-readable artifacts (15)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/makeup-land/refs/heads/main/openapi/makeup-land-customers-api-openapi.yml
- **Documentation** — https://makeup.land/llms-full.txt
- **APIReference** — https://makeup.land/openapi.json
- **GettingStarted** — https://makeup.land/llms-api.txt
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/makeup-land/refs/heads/main/authentication/makeup-land-authentication.yml
- **Authentication** — https://makeup.land/auth.md
- **OAuthScopes** — https://raw.githubusercontent.com/api-evangelist/makeup-land/refs/heads/main/scopes/makeup-land-scopes.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/makeup-land/refs/heads/main/conventions/makeup-land-conventions.yml
- **Idempotency** — https://raw.githubusercontent.com/api-evangelist/makeup-land/refs/heads/main/conventions/makeup-land-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/makeup-land/refs/heads/main/errors/makeup-land-problem-types.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/makeup-land/refs/heads/main/rate-limits/makeup-land-rate-limits.yml
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/makeup-land/refs/heads/main/lifecycle/makeup-land-lifecycle.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/makeup-land/refs/heads/main/data-model/makeup-land-data-model.yml
- **Conformance** — https://raw.githubusercontent.com/api-evangelist/makeup-land/refs/heads/main/conformance/makeup-land-conformance.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/makeup-land/refs/heads/main/asyncapi/makeup-land-webhooks.yml

## Other makeup.land APIs (10)

- [makeup.land MCP Server](https://apis.io/apis/makeup-land/makeup-land-mcp-server/)
- [makeup.land Merchant & Agentic Commerce Feeds](https://apis.io/apis/makeup-land/makeup-land-merchant-feeds/)
- [makeup.land Brands API](https://apis.io/apis/makeup-land/makeup-land-brands-api/)
- [makeup.land Cart API](https://apis.io/apis/makeup-land/makeup-land-cart-api/)
- [makeup.land Gift Cards API](https://apis.io/apis/makeup-land/makeup-land-gift-cards-api/)
- [makeup.land Orders API](https://apis.io/apis/makeup-land/makeup-land-orders-api/)
- [makeup.land Payment Links API](https://apis.io/apis/makeup-land/makeup-land-payment-links-api/)
- [makeup.land Products API](https://apis.io/apis/makeup-land/makeup-land-products-api/)
- [makeup.land Proposals API](https://apis.io/apis/makeup-land/makeup-land-proposals-api/)
- [makeup.land Register API](https://apis.io/apis/makeup-land/makeup-land-register-api/)

## Tags

Customers

---

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