---
title: "Abertura de conta"
method: POST
path: "/business/{documentNumber}/accounts"
tags: ["Conta pessoa jurídica"]
---

# Abertura de conta

`POST /business/{documentNumber}/accounts`

## Request

- Base URL: `https://api-mtls.sandbox.bankly.com.br`
- URL: `https://api-mtls.sandbox.bankly.com.br/business/{documentNumber}/accounts`
- Auth: HTTP bearer

<div class="bkly-ref-description">
  <p>Crie contas de pagamento para clientes do tipo pessoa jurídica que tiveram seu registro previamente aprovado.</p>
  <span class="bkly-ref-small-stable-tag">stable</span> 
  <span class="bkly-ref-scope-tag">scope: account.create</span>
</div>  
[block:callout]
  {
    "type": "warning",
    "title": "Importante",
    "body": "Caso cliente possua [multicontas](https://docs.bankly.com.br/docs/multi-accounts) ativas, o parceiro deverá utilizar o cabeçalho <code>Idempotency-Key</code> nas requisições, a fim de evitar a criação de contas duplicadas. Para mais informações, confira a documentação [Abertura de conta](/docs/abertura-de-conta-pessoa-juridica). "
  }
[/block]

## Headers

- `Idempotency-Key` string

## Parameters

- `#/paths/~1business~1{documentNumber}~1accounts/get/parameters/0` (unresolved $ref)
- `#/paths/~1legal-agreements~1file/get/parameters/0` (unresolved $ref)
- `#/paths/~1legal-agreements~1file/get/parameters/1` (unresolved $ref)

## Request body

- CreateAccountRequest
  - `accountType` 'PAYMENT_ACCOUNT': Tipo da conta a ser criada.

## Response `201`

Recurso criado com sucesso.

- AccountDetailedResponsePost
  - `balance` SummarizedBalance: Objeto que contém informações sobre o saldo sumarizado da conta.
    - `inProcess` Balance: Saldo da conta.
      - `amount` number, double: Valor em decimal.
      - `currency` string: Código da moeda com base na ISO 4217. _Default: *BRL*_
    - `available` Balance: Saldo da conta.
      - `amount` number, double: Valor em decimal.
      - `currency` string: Código da moeda com base na ISO 4217. _Default: *BRL*_
    - `blocked` Balance: Saldo da conta.
      - `amount` number, double: Valor em decimal.
      - `currency` string: Código da moeda com base na ISO 4217. _Default: *BRL*_
  - `status` 'ACTIVE' | 'CLOSED': Situação da conta.
  - `branch` string: Número da agência bancária.
  - `number` string: Número da conta de pagamento.

## Other responses

- `400` (unresolved $ref)
- `403` (unresolved $ref)
- `409` (unresolved $ref)
- `422` (unresolved $ref)
- `500` (unresolved $ref)

---

[API](https://skmtc.dev/bankly/apis/gest-o-de-contas.md) - [All operations](https://skmtc.dev/bankly/apis/gest-o-de-contas/llms.txt) - [OpenAPI document](https://skmtc.dev/bankly/apis/gest-o-de-contas/revisions/39000596dbd3?raw)