Create new customer

Creates a new customer in the Asaas account. Use this operation to register a payer that will be referenced in payments, subscriptions and other operations linked to customers.

The response represents the created customer and includes its Asaas ID. Store this identifier to reuse it in subsequent operations.

The API allows duplicate customers to be created. If your integration requires unique records, check the existing customers before creating one. In case of a timeout or an inconclusive response, check whether the record was created before repeating the request.

When postalCode is provided, Asaas may automatically fill in address data based on the postal code (CEP). Provide addressNumber separately when applicable.

⚠️

Foreign customers

To register a foreign payer, provide foreignCustomer: true.

In Production, the feature must be enabled for the account. In the Sandbox, enable Foreign payers in the account settings.

Related content

Guides

Body Params
string
required

Client name

string
required

Customer CPF or CNPJ

string

Customer email

string

Landline

string

Cell phone

string

Public place

string

Address number

string

Address complement (max. 255 characters)

string

Neighborhood

string

Address zip code

string

Customer identifier in your system

boolean

true to disable sending billing notifications

string

Additional emails for sending billing notifications separated by ","

string

Customer municipal registration

string

Customer state registration

string

Additional observations

string

Name of the group the customer belongs to. To associate the customer with more than one group, use the "groupNames" attribute

groupNames
array of strings

List of names of the groups the customer belongs to (maximum of 20 per call). Can be used together with "groupName"

groupNames
string

Company

boolean

inform true if it's a non-brazilian customer

Responses

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