Create subaccount

Creates a new subaccount linked to the authenticated parent account.

The parent account creating the subaccount must be a legal entity (CNPJ).

The response includes the new subaccount's apiKey and walletId. Capture the apiKey from the creation response, because its value cannot be retrieved later.

When webhooks is provided, the Webhook configurations are created together with the subaccount.

⚠️

Subaccount postal code (CEP)

Provide a valid postal code (CEP) in postalCode. Asaas uses this value to identify the city of the address and returns 400 when the postal code cannot be found.

📘

Free-of-charge closure

Non-BaaS subaccounts closed within 48 hours of creation are not charged the creation fee, when applicable. For this, the subaccount must meet the non-BaaS subaccount closure criteria, including never having logged in. After this period, closure through this flow is no longer allowed.

See the amounts applicable to your contract in Account Settings > Fees.

Related content

Guides

Body Params
string
required

Subaccount name

string
required

Subaccount email

string

Email for subaccount login, if not provided, the subaccount email will be used

string
required

CPF or CNPJ of the subaccount owner

date

Date of birth (only for Individuals)

string
enum

Type of company (only when Legal Entity)

Allowed:
string

Telephone

string
required

Cellphone

string

Url reffered to the subaccount

number
required

Billing/Monthly income

string
required

Public place

string
required

Address number

string

Address complement

string
required

Neighborhood

string
required

Address zip code

webhooks
array of objects

Array with desired Webhooks settings

webhooks
string
enum

Tax regime (only when Legal Entity)

Allowed:
Responses

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