Creating Whitelabel subaccounts

With White Label enabled, your client will not have access to our system and will not receive any type of communication from Asaas. It is your responsibility to make the desired features from our API documentation available within your integrated system.

The process to start creating White Label subaccounts can be summarized as follows:

• Request the release of this feature from your account manager;
• Create the Asaas subaccount with Webhooks configured;
• Submit the subaccount documentation via onboarding with document submission link;
• Check the subaccount’s registration status.

🚧

The White Label format must be previously aligned and implemented by your account manager. Creating Asaas accounts using the methods listed below without prior agreement on the White Label setup will result in subaccounts being created outside this structure.
In the Sandbox environment, for testing purposes, simply contact Support and request access.

Creating the subaccount with Webhooks configured

POST /v3/accounts
Check the full reference for 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",
    "webhooks": [
        {
            "name": "Payment Webhook",
            "url": "http://mywebsite.com/webhook/payments",
            "email": "[email protected]",
            "sendType": "SEQUENTIALLY",
            "interrupted": false,
            "enabled": true,
            "apiVersion": 3,
            "authToken": "5tLxsL6uoN",
            "events": ["PAYMENT_CREATED", "PAYMENT_UPDATED", "PAYMENT_CONFIRMED", "PAYMENT_RECEIVED"]
        }
    ]
}

It is essential to configure Webhooks at the very beginning for White Label subaccounts to ensure no account creation or update events are missed, and to avoid the need for additional requests to set up these methods later.

More details about the available Webhook events can be found in the Webhook integrations guide.