---
title: "Editar cliente"
method: PUT
path: "/customers/{customer_id}"
---

# Editar cliente

`PUT /customers/{customer_id}`

## Request

- Base URL: `https://api.pagar.me/core/v5`
- URL: `https://api.pagar.me/core/v5/customers/{customer_id}`
- Auth: HTTP basic

## Path parameters

- `customer_id` string, required

## Request body

- object
  - `name` string: Nome do cliente. Max: 64 caracteres.
  - `email` string: E-mail do cliente. Max: 64 caracteres
  - `code` string: Código de referência do cliente no sistema da loja. Max: 52 caracteres
  - `document` string: CPF, CNPJ ou PASSAPORTE do cliente. Max: 16 caracteres para CPF e CNPJ e Max: 50 caracteres para PASSAPORTE
  - `document_type` string: Tipo de documento. Valores possíveis: CPF, CNPJ ou PASSPORT.
  - `type` string: Tipo de cliente. Valores possíveis: **individual** (pessoa física) ou **company** (pessoa jurídica).<br>**Obrigatório**, caso o `document` seja enviado.
  - `gender` string: Sexo do cliente . Valores possíveis: **male** ou **female**
  - `address` object: Endereço do cliente. [Saiba mais sobre endereços](https://docs.pagar.me/reference/endere%C3%A7os)
    - `line_1` string: Linha 1 do endereço. (Número, Rua, e Bairro - Nesta ordem e separados por vírgula) Max: 256 caracteres.
    - `line_2` string: Linha 2 do endereço. (Complemento - Andar, Sala, Apto). Max: 128 caracteres.
    - `zip_code` string: CEP. Max: 16 caracteres. (Apenas numérico)
    - `city` string: Cidade. Max: 64 caracteres.
    - `state` string: Código do estado no formato ISO 3166-2. <a href="https://pt.wikipedia.org/wiki/ISO_3166-2" target="_blank">Saiba mais sobre ISO 3166-2</a>
    - `country` string: Código do país no formato ISO 3166-1 alpha-2. <a href="https://pt.wikipedia.org/wiki/ISO_3166-1_alfa-2" target="_blank">Saiba mais sobre ISO 3166-1 alpha-2</a>
    - `metadata` string: Objeto chave/valor utilizado para armazenar informações adicionais sobre o endereço. [Saiba mais sobre metadata](https://docs.mundipagg.com/v1/reference#metadata)
  - `phone` object: Telefones do cliente. [Saiba mais sobre o telefones](https://docs.pagar.me/reference#telefones-1)
  - `birthdate` string, date: Data de nascimento do cliente.
  - `metadata` string: Objeto chave/valor utilizado para armazenar informações adicionais sobre o cliente. [Saiba mais sobre metadata](https://docs.pagar.me/reference/metadata-1)

## Response `200`

200

- object
  - `id` string
  - `name` string
  - `email` string
  - `document` string
  - `gender` string
  - `type` string
  - `delinquent` boolean
  - `created_at` string
  - `updated_at` string
  - `phones` object
    - `home_phone` object
      - `country_code` string
      - `number` string
      - `area_code` string
  - `metadata` object
    - `id` string

## Other responses

- `422`: 422

## Changes

- **2026-11-03** `ef323290c0ff`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pagar/apis/pagarme-api/changes/customers/:customer_id/put.md)

---

[API](https://skmtc.dev/pagar/apis/pagarme-api.md) - [All operations](https://skmtc.dev/pagar/apis/pagarme-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pagar/apis/pagarme-api/revisions/ef323290c0ff?raw)