Criar novo cliente

Recipes
🦉
Desabilitar notificações ao criar cliente
Open Recipe
🦉
Padronizar notificações para novos clientes
Open Recipe

Cria um novo cliente na conta Asaas. Use esta operação para registrar um pagador que será referenciado em cobranças, assinaturas e outras operações vinculadas a clientes.

A resposta representa o cliente criado e inclui seu ID no Asaas. Armazene esse identificador para reutilizá-lo nas operações posteriores.

A API permite a criação de clientes duplicados. Se sua integração exigir unicidade cadastral, consulte os clientes existentes antes da criação. Em caso de timeout ou resposta inconclusiva, verifique se o cadastro foi criado antes de repetir a requisição.

Quando postalCode é informado, o Asaas pode preencher automaticamente dados do endereço com base no CEP. Informe addressNumber separadamente quando aplicável.

⚠️

Clientes estrangeiros

Para cadastrar um pagador estrangeiro, informe foreignCustomer: true.

Em Produção, o recurso depende de liberação para a conta. No Sandbox, habilite Pagadores estrangeiros nas configurações da conta.

Conteúdos relacionados

Guides

Body Params
string
required

Nome do cliente

string
required

CPF ou CNPJ do cliente

string

Email do cliente

string

Fone fixo

string

Fone celular

string

Logradouro

string

Número do endereço

string

Complemento do endereço (máx. 255 caracteres)

string

Bairro

string

CEP do endereço

string

Identificador do cliente no seu sistema

boolean

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

string

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

string

Inscrição municipal do cliente

string

Inscrição estadual do cliente

string

Observações adicionais

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
string

Empresa

boolean

informe true caso seja pagador estrangeiro

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json