---
title: "Criar uma nova conta"
method: POST
path: "/escrow/api/v1/accounts"
tags: ["Contas"]
---

# Criar uma nova conta

`POST /escrow/api/v1/accounts`

## Request

- Base URL: `https://sandbox.platform.credit.celcoin.com.br`
- URL: `https://sandbox.platform.credit.celcoin.com.br/escrow/api/v1/accounts`
- Auth: none declared

Esse endpoint permite ao operador enviar uma solicitação para a abertura de uma nova conta escrow.

Após o processamento da requisição do operador, a nova conta ficará no status de "aguardando analise" (WAITING_ANALYSIS), até sua posterior aprovação e liberação para uso.

#### Parâmetros da Requisição

- `personId` (string/uuid v4, obrigatório): ID de cadastro da Pessoa.
    
- `parties` (object, obrigatório): Objeto contendo os dados das partes envolvidas.
    
- `tenantType` (string): Tipo da estrutura onde a conta será alocada. Possíveis valores: 'default', 'prime'.
    
- `accountType` (string): Tipo da conta. Possíveis valores: 'ESCROW', 'PAYMENT'.
    

##### Objeto "parties"

- `person` (object, obrigatório): Objeto contendo os dados da Pessoa.
    
- `person -> id` (string, obrigatório): ID de cadastro da Pessoa.
    
- `person -> businessType` (string, obrigatório): Tipo da pessoa participante na conta. Possíveis valores aceitos: 'FUND', 'MANAGER', 'SECURITIZER', 'CONSULTANT', 'CUSTODIAN', 'ADMINISTRATOR', 'OTHERS'.
    
- `signContract` (boolean, obrigatório): Flag para indicar se terá assinatura de contrato.
    
- `permissions` (array, obrigatório): Lista com as permissões a serem aplicadas na conta.
    

##### Objeto "permissions"

O objeto "permissions" pode receber uma lista com as permissões a serem liberadas na conta. Possíveis valores:

- MANAGE_USER
    
- VIEW_ACCOUNT
    
- CREATE_POSTING
    
- REVIEW_POSTING
    
- POSTING_VIEW
    
- CREATE_WALLET
    
- VIEW_WALLET
    
- UPDATE_WALLET
    
- ARCHIVE_WALLET
    
- CREATE_CHARGE
    
- CANCEL_CHARGE
    
- VIEW_CHARGE
    
- UPDATE_CHARGE
    
- CREATE_APPROVED
    
- CREATE_BALANCE_RETENTION
    
- REMOVE_BALANCE_RETENTION
    
- VIEW_BALANCE_RETENTION
    
- CREATE_ACCOUNT
    
- CREATE_BENEFICIARY
    
- CREATE_DEPOSIT_RETENTION
    
- VIEW_DEPOSIT_RETENTION
    
- DELETE_DEPOSIT_RETENTION
    
- UPDATE_DEPOSIT_RETENTION
    

#### Resposta

Se a requisição for processada com sucesso será retornado um código 200 e um JSON no seguinte formato:

- `id` (string): ID para identificação da solicitação cadastrada.
    

##### Exemplo de JSON:

``` json
{
  "id": "<string>"
}

 ```

## Headers

- `Content-Type` string
- `Accept` string

## Request body

- object

## Response `200`

OK

- object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/celcoin/apis/celcoin-escrow.md) - [All operations](https://skmtc.dev/celcoin/apis/celcoin-escrow/llms.txt) - [OpenAPI document](https://skmtc.dev/celcoin/apis/celcoin-escrow/revisions/5d55a35a6d51?raw)