---
title: "Creates a bank account"
method: POST
path: "/bank-accounts"
tags: ["Bank accounts"]
---

# Creates a bank account

`POST /bank-accounts`

Registers a treasury bank account with currency, institution identifiers, and linkage to the GL cash account used during transaction import.
Accurate mapping here ensures invoice payments, bill payments, and bank feeds all post to the same cash subledger.

## Request body

- CreateBankAccountRequest
  - `name` string, required — The bank account name
  - `currency` string, required — Currency code following ISO-4217
  - `bank_name` string, required
  - `subsidiary_id` string, uuid, required
  - `account_code` string, required — The account code found in the Chart of Accounts
  - `mask` string — Last digits of the bank account number
  - `transactions_start_date` string, date — The earliest date from which bank transactions are tracked for this account. Defaults to the date of creation when omitted.

## Response `200`

OK

- BankAccount
  - `id` string, uuid, required
  - `name` string, required — The bank account name
  - `currency` string, required — Currency code following ISO-4217
  - `bank_name` string, required
  - `subsidiary_id` string, uuid
  - `account_code` string — The account code found in the Chart of Accounts
  - `mask` string — Last digits of the bank account number
  - `transactions_start_date` string, date, nullable — The earliest date from which bank transactions are tracked for this account. Omitted for pre-existing accounts that have no recorded start date.
  - `status` 'ACTIVE' | 'INACTIVE', required

## Other responses

- `default` — Error

---

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