---
title: "Cria uma conta manual"
method: POST
path: "/api/v1/accounts"
tags: ["Contas", "Escrita e desfazer"]
---

# Cria uma conta manual

`POST /api/v1/accounts`

## Request

- Base URL: `https://snabber.com.br`
- URL: `https://snabber.com.br/api/v1/accounts`
- Auth: HTTP bearer

Conta sem Open Finance: `BANK` ou `CREDIT` (com dias de fechamento e vencimento opcionais).

## Query parameters

- `workspace_id` integer

## Request body

- AccountInput
  - `name` string, required
  - `type` 'BANK' | 'CREDIT'
  - `balance` number
  - `currency_code` string
  - `statement_closing_date` integer
  - `payment_due_date` integer

## Response `201`

Criada

- AccountWriteResult
  - `status` string
  - `undo_id` integer
  - `account` object
  - `renamed_transactions` integer

## Other responses

- `401`: Chave de API ausente, inválida, revogada ou expirada
- `403`: `INSUFFICIENT_SCOPE` (chave sem a permissão de escrita/exclusão), `WORKSPACE_READ_ONLY` (seu papel no workspace é somente leitura) ou `TRANSACTION_QUOTA_EXCEEDED` (cota mensal de transações)
- `409`: Já existe uma conta com esse nome no workspace
- `422`: Dados inválidos (`details.field` diz qual), conta inexistente no workspace (`details.available`), etc.
- `429`: Limite de requisições ou teto diário de escrita da chave (`DAILY_WRITE_LIMIT`)
- `503`: Escrita pela API temporariamente desativada (`WRITES_DISABLED`)

---

[API](https://skmtc.dev/snabber/apis/snabber-api.md) · [All operations](https://skmtc.dev/snabber/apis/snabber-api/llms.txt) · [OpenAPI document](https://skmtc.dev/snabber/apis/snabber-api/revisions/bf5841cbd8ce?raw)