---
title: "Criação de conta pocket"
method: POST
path: "/accounts/{accountNumber}/pockets"
tags: ["Conta pocket"]
---

# Criação de conta pocket

`POST /accounts/{accountNumber}/pockets`

## Request

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

<div class="bkly-ref-description">
  <p>Crie uma conta pocket para que seja possível guardar dinheiro fora da conta de pagamento.</p> 
  <span class="bkly-ref-small-stable-tag">stable</span> 
  <span class="bkly-ref-scope-tag">pocket.create</span>
</div>
[block:callout]
{
  "type": "warning",
  "title": "Importante",
  "body": "Para criar uma conta pocket, é necessário ter uma conta de pagamento ativa. Para mais informações, consulte a documentação [Criação de conta pocket](/docs/criacao-de-conta-pocket)."
}
[/block]

## Path parameters

- `accountNumber` string, nullable, required

## Headers

- `idempotency-key` string, required: Informe um GUID v4.

## Parameters

- `#/paths/~1pockets~1{pocketNumber}/get/parameters/2` (unresolved $ref)
- `#/paths/~1legal-agreements~1file/get/parameters/1` (unresolved $ref)

## Request body

- CreatePocketRequestRequest
  - `data` CreatePocketRequest
    - `user` User, required
      - `name` string, required: Nome do usuário da conta pocket.
      - `document` Document, required
        - `value` string, nullable: Número do documento do usuário.
        - `type` 'CPF' | 'CNPJ': Tipo do documento do titular da conta.
      - `birthDate` string, date-time, required: Data de nascimento do usuário da conta pocket.
    - `currency` string, required: Sigla da moeda utilizada, de acordo com a ISO 4217.
    - `label` string, required: Label para criação da conta pocket.
    - `useCase` 'CORPORATE_EXPENSES' | 'FLEXIBLE_BENEFITS' | 'BALANCE_SEGREGATION', required
  - `metadata` object, nullable

## Response `201`

Recurso criado com sucesso.

- CreatePocketResponseComp
  - `data` CreatePocketCompleteResponseDto
    - `number` string: Número da conta pocket.
    - `label` string: Nome descritivo da conta pocket.
    - `suffix` string: Sufixo atribuído ao número da pocket. Exemplo: BRL.
    - `currency` string: Sigla da moeda corrente da pocket.
    - `type` string: Tipo da conta com a sigla da moeda. Exemplo: POCKET_BRL.
    - `status` string: Situação da conta pocket, que pode ser: ACTIVE, DORMANT, LOCKED e CLOSED.
    - `reason` string: Motivo da situação da conta pocket. Nesse caso, sempre será HOLDER_REQUEST.
    - `category` string: Categoria da conta.
    - `useCase` string: Especificação da finalidade da pocket, que pode ser: “ACCOUNT_FOR_UNDER_AGE” (Conta para menor de idade), “CORPORATE_EXPENSES” (Despesas corporativas), “FLEXIBLE_BENEFITS” (Benefícios flexíveis) e “BALANCE_SEGREGATION” (Segregação de saldo).
    - `createdAt` string: Data de criação da conta pocket, no formato yyyy-MM-dd'T'HH:mm:ss.SSS.
    - `user` User
      - `name` string, required: Nome do usuário da conta pocket.
      - `document` Document, required
        - `value` string, nullable: Número do documento do usuário.
        - `type` 'CPF' | 'CNPJ': Tipo do documento do titular da conta.
      - `birthDate` string, date-time, required: Data de nascimento do usuário da conta pocket.
    - `account` AccountCompleteResponse
      - `branch` string: Número da agência da conta de pagamento à qual a conta pocket está atrelada.
      - `number` string: Número da conta de pagamento.
      - `status` string: Situação da conta de pagamento que, nesse caso, será “ACTIVE”.
      - `reason` string: Motivo da situação da conta de pagamento.
      - `createdAt` string: Data de criação da conta de pagamento, no formato yyyy-MM-dd'T'HH:mm:ss.SSS.
      - `bank` Bank
        - `ispb` string: ISPB (Identificador de Sistema de Pagamentos Brasileiro) do banco.
        - `code` string: Código do banco.
        - `name` string: Nome do banco.
      - `holder` HolderCompleteResponse
        - `document` Document
          - `value` string, nullable: Número do documento do usuário.
          - `type` 'CPF' | 'CNPJ': Tipo do documento do titular da conta.
        - `type` string: Tipo do cadastro do titular da conta de pagamento (“CUSTOMER” ou “BUSINESS”).
        - `name` string: Nome do titular da conta de pagamento.
        - `status` string: Situação do cadastro do titular.
        - `createdAt` string: Data de criação do cadastro do titular no formato yyyy-MM-dd'T'HH:mm:ss.SSS.
  - `links` Link[], nullable
    - `url` string, nullable: URLs que podem ser utilizadas em um próximo estado da entidade. Nesse caso, trata-se da própria requisição realizada.
    - `rel` string, nullable: Descrição de como a URL se relaciona com o recurso atual.
    - `method` string, nullable: Tipo de verbo que deve ser utilizado para acessar a URL. Nesse caso, é o GET.
  - `metadata` object, nullable

## Other responses

- `400` (unresolved $ref)
- `401` (unresolved $ref)
- `403` (unresolved $ref)
- `422` (unresolved $ref)
- `500` (unresolved $ref)
- `503` (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)