---
title: "Create bank account"
method: POST
path: "/consumers/{consumer_id}/accounting/bank-accounts"
tags: ["Accounting", "Bank accounts"]
---

# Create bank account

`POST /consumers/{consumer_id}/accounting/bank-accounts`

Create a new bank account in the accounting system

## Path parameters

- `consumer_id` string, uuid, required

## Query parameters

- `folder_id` string, nullable

## Request body

- BankAccountItemIn
  - `code` string, required — A userfriendly code to represent the bank account. This will be used as the code of the journal if we need to create a journal for the bank account.
  - `currency` string, required — Currency of the bank account (e.g., EUR, USD).
  - `account_name` string, nullable — Name of the bank account. Represents this specific bank account in the accounting system.
  - `account_number` string, nullable — Unique number representing the bank account. At least one of the fields 'account_number' or 'IBAN' must be filled in.
  - `iban` string, nullable — IBAN of the bank account. At least one of the fields 'account_number' or 'IBAN' must be filled in.
  - `bank_name` string, required — Name of the bank linked to the bank account.

## Response `200`

Successful Response

- BankAccountItemOut
  - `id` string, required
  - `code` string, nullable — A userfriendly code to represent the bank account. This will be used as the code of the journal if we need to create a journal for the bank account.
  - `currency` string, nullable — Currency of the bank account (e.g., EUR, USD).
  - `account_name` string, nullable — Name of the bank account. Represents this specific bank account in the accounting system.
  - `account_number` string, nullable — Unique number representing the bank account.
  - `iban` string, nullable — IBAN of the bank account.
  - `bank_name` string, nullable — Name of the bank linked to the bank account.
  - `journal_id` string, nullable — Indicates the journal used in the accounting system to represent the bank account. The journal contains all the transactions related to this specific bank account.
  - `ledger_account` string, nullable — Indicates the ledger account used in the accounting system to represent the bank account. The ledger account is used in all the transactions related to this specific bank account. This ledger account is used to track the balance of the bank account.
  - `unallocated_account` string, nullable — Unallocated ledger account used to book entries when the final ledger account / client / supplier / employee is not yet known (specific to bank and cash journals)

## Other responses

- `400` — Bad Request
- `422` — Validation Error

---

[API](https://skmtc.net/chift/apis/chift-api.md) · [All operations](https://skmtc.net/chift/apis/chift-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chift/chift-api/revisions/b5f1214a482a/schema)