---
title: "Cria um cliente"
method: POST
path: "/v1/customers"
tags: ["Customers"]
---

# Cria um cliente

`POST /v1/customers`

## Request

- Base URL: `https://api.sandbox.mupag.com.br`
- URL: `https://api.sandbox.mupag.com.br/v1/customers`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string, required

## Request body

- CustomerRequest
  - `name` string, required
  - `email` string, email, required
  - `tax_id` string
  - `phone` string
  - `birth_date` string, date
  - `external_reference` string
  - `marketing_consent` boolean

## Response `201`

Cliente criado

- CustomerResponse
  - `id` string, uuid, required
  - `merchant_id` string, uuid, required
  - `environment` string, required
  - `name` string, required
  - `email` string, email, required
  - `tax_id` string
  - `phone` string
  - `birth_date` string, date
  - `external_reference` string
  - `marketing_consent` boolean, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `401`: Falha de autenticação
- `403`: Permissão insuficiente
- `409`: Conflito de idempotência ou estado
- `422`: Erro de validação
- `429`: Limite de requisições excedido

---

[API](https://skmtc.dev/mupag/apis/mupag-public-merchant-api.md) · [All operations](https://skmtc.dev/mupag/apis/mupag-public-merchant-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mupag/apis/mupag-public-merchant-api/revisions/677904516d2d?raw)