Criar subconta

post

https://api-sandbox.asaas.com/v3/accounts

Recipes

🦉

Criar uma subconta e armazenar a API Key com segurança

Open Recipe

Cria uma nova subconta vinculada à conta-pai autenticada.

A conta-pai que realiza a criação deve ser pessoa jurídica (CNPJ).

A resposta inclui a apiKey e o walletId da nova subconta. Capture a apiKey na resposta da criação, pois seu valor não poderá ser recuperado posteriormente.

Quando webhooks for informado, as configurações de Webhook são criadas junto com a subconta.

⚠️
CEP da subconta
Informe um CEP válido em postalCode. O Asaas utiliza esse valor para identificar a cidade do endereço e retorna 400 quando o CEP não pode ser localizado.

Conteúdos relacionados

Guides

Body Params

name

string

required

Nome da subconta

string

required

Email da subconta

loginEmail

string

Email para login da subconta, caso não informado será utilizado o email da subconta

cpfCnpj

string

required

CPF ou CNPJ do proprietário da subconta

birthDate

date

Data de nascimento (somente quando Pessoa Física)

companyType

string

enum

Tipo da empresa (somente quando Pessoa Jurídica)

Allowed:

phone

string

Telefone Fixo

mobilePhone

string

required

Telefone Celular

site

string

URL of the subbacount website

incomeValue

number

required

Faturamento/Renda mensal

address

string

required

Logradouro

addressNumber

string

required

Número do endereço

complement

string

Complemento do endereço

province

string

required

Bairro

postalCode

string

required

CEP do endereço

webhooks

array of objects

Array com as configurações de Webhooks desejadas

webhooks

Responses

CEP da subconta

Conteúdos relacionados

Guides

200Ok

400Bad Request

401Unauthorized