Atualizar cliente existente

put

https://api-sandbox.asaas.com/v3/customers/{id}

Recipes

🦉

Desabilitar notificações ao criar cliente

Open Recipe

Atualiza os dados cadastrais de um cliente existente pelo ID.

Use esta operação para manter o cadastro do cliente atualizado sem criar um novo registro. A resposta representa o cliente após a atualização e mantém o mesmo ID.

A atualização altera o cadastro do cliente, mas não modifica automaticamente cobranças, assinaturas ou outros recursos já existentes. As novas informações podem ser utilizadas nas operações realizadas após a alteração cadastral.

📘
Campos enviados
Envie apenas os campos que precisam ser alterados. Para preservar a informação atual de um campo, não o envie na requisição.
Evite enviar campos vazios, nulos ou valores padrão quando a intenção for manter o valor existente.

A alteração de notificationDisabled modifica a configuração de envio de notificações de cobrança do cliente. Para configurar eventos ou canais específicos, utilize os endpoints de notificações.

Conteúdos relacionados

Guides

Cadastro de clientes

Path Params

string

required

Identificador único do cliente a ser atualizado

Body Params

name

string

Nome do cliente

cpfCnpj

string

CPF ou CNPJ do cliente

string

Email do cliente

phone

string

Fone fixo

mobilePhone

string

Fone celular

address

string

Logradouro

addressNumber

string

Número do endereço

complement

string

Complemento do endereço

province

string

Bairro

postalCode

string

CEP do endereço

externalReference

string

Identificador do cliente no seu sistema

notificationDisabled

boolean

true para desabilitar o envio de notificações de cobrança

additionalEmails

string

Emails adicionais para envio de notificações de cobrança separados por ","

municipalInscription

string

Inscrição municipal do cliente

stateInscription

string

Inscrição estadual do cliente

observations

string

Observações adicionais

groupName

string

Nome do grupo ao qual o cliente pertence. Para associar o cliente a mais de um grupo, utilize o atributo "groupNames"

groupNames

array of strings

Lista de nomes dos grupos aos quais o cliente pertence (máximo de 20 por chamada). Pode ser utilizado em conjunto com "groupName"

groupNames

company

string

Empresa

foreignCustomer

boolean

informe true caso seja pagador estrangeiro

Responses

404

Not found

Campos enviados

Conteúdos relacionados

Guides

200Ok

400Bad Request

401Unauthorized