Update existing customer

Endpoint responsible for updating the registration data of an existing customer in Asaas.


Request parameter

  • id — Customer's unique identifier

Main request parameters

  • name, cpfCnpj, email
  • phone, mobilePhone
  • address, addressNumber, complement, province, postalCode
  • externalReference
  • notificationDisabled, additionalEmails
  • municipalInscription, stateInscription
  • observations, groupName, company
  • foreignCustomer

When to use this endpoint

  • updating contact information
  • correcting address details
  • adjusting internal references
  • synchronizing data

Integration considerations

The update must always use the correct customer identifier in Asaas.


❗️

Attention

It is recommended to persist the customer ID from the moment of creation or retrieve it beforehand through a query before performing the update.


Best practices for synchronization

Define a single source of truth for the data (ERP, CRM, or Asaas) to avoid unintended overwrites.


Path Params
string
required
Body Params
string
string
string
string
string
string
string
string
string
string
string
boolean
string
string
string
string
string
string
boolean
Responses

404

Not found

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