# Como criar uma subconta

> :::info
> Para a utilização desta funcionalidade é necessário possuir a funcionalidade Subconta
> :::

Atualmente a criação de uma subconta é feita apenas via API. Para isso você pode está utilizando o _endpoint_ `/api/v1/subaccount` da API.

Você pode acessar [aqui](/api#tag/subaccount)/paths/~1api~1v1~1subaccount/post)
a documentação referente a esse _endpoint_.

Os campos obrigatórios para criar uma subconta são os seguintes:

- **`name`**: O nome de identificação da subconta.
- **`pixKey`**: A chave PIX da subconta (Não precisa ser necessariamente atrelada a uma conta da woovi).

A chave PIX será checada antes de criar a subconta. Caso a chave não exista, a subconta não será criada e uma mensagem de erro será retornada.

### Exemplos em código

  

**Shell + cURL**

```sh
  curl 'https://api.woovi.com/api/v1/subaccount' -X POST \
      -H "Accept: application/json" \
      -H "Content-Type: application/json" \
      -H "Authorization": "app_id"
      --data-binary '{"name":"subaccount#1","pixKey": "destinatario@woovi.com.br"}'
```

  
  

**JavaScript + Fetch**

```js
fetch('https://api.woovi.com/api/v1/subaccount', {
  method: 'POST',
  body: JSON.stringify({
    name: "subaccount#1",
    pixKey: "destinatario@woovi.com.br"
  }),
  headers: {
    Authorization: 'app_id',
    'Content-Type': 'application/json',
  },
}).then((res) => res.json());
```