Creating subaccounts

Creating subaccounts allows you to create Asaas accounts for your partners/clients linked to a root account, so they can use all Asaas functionalities through our website, app, or through an integrated platform developed by you.

As a response to the creation of the Asaas subaccount, you will receive the API key (apiKey) of the created subaccount to proceed with the integration, and also the walletId if you wish to work with Payment Split or with Transfer between Asaas accounts.

Remember that, although the subaccounts generated under your root account inherit rate settings and management from the root account, other settings must be made individually in each created subaccount, such as webhooks, tax information for invoicing, etc.

📘

The creation of subaccounts incurs charges for each account created, check in Account Settings > Fees, which fees apply.

Creation of the subaccount with Webhooks being configured

POST /v3/accounts
Check the complete reference of this endpoint

{
    "name": "Subaccount created via API",
    "email": "[email protected]",
    "cpfCnpj": "66625514000140",
    "birthDate": "1994-05-16",
    "companyType": "MEI",
    "phone": "11 32300606",
    "mobilePhone": "11 988451155",
    "address": "Av. Rolf Wiest",
    "addressNumber": "277",
    "complement": "Room 502",
    "province": "Bom Retiro",
    "postalCode": "89223005",
}

🚧

Important

In Sandbox, it is only possible to create 20 subaccounts per day, if the account reaches the daily limit it will receive an error notification.

In addition, all communications of subaccounts in Sandbox will be sent to the email of the root account. The subaccount owner receives notifications.

Storing the subaccount's API key

The following calls for document submission must be made using the API key of the created subaccount. The key will be returned as a response from the account creation request and must be stored at that time, as it cannot be retrieved later.