---
title: "Create Customer Bank Account"
method: POST
path: "/v2/customers/{customerId}/bankaccounts"
tags: ["customer"]
---

# Create Customer Bank Account

`POST /v2/customers/{customerId}/bankaccounts`

## Request

- Base URL: `https://scx-sbx.api.jtl-software.com`
- URL: `https://scx-sbx.api.jtl-software.com/v2/customers/{customerId}/bankaccounts`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://auth.jtl-cloud.com/oauth2/auth`
    - Token URL: `https://auth.jtl-cloud.com/oauth2/token` scopes: `customers.write`
  - OAuth 2
    - Client credentials
    - Token URL: `https://auth.jtl-cloud.com/oauth2/token` scopes: `customers.write`
- TypeScript: <https://skmtc.dev/jtl-software/apis/scx-authentication-api/docs/v2/customers/:customerId/bankaccounts/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a new bank account for a specific customer

## Path parameters

- `customerId` string, uuid, required: Represents a unique key for identifying a customer in the JTL system.

## Headers

- `x-tenant-id` string, uuid, required
- `x-runas` string
- `x-companyid` string

## Request body

- JTLWawiRestContractsModelsV1CustomerCreateCustomerBankAccount: Model Class: CreateCustomerBankAccount
  - `accountHolder` string: Name of the account holder of the customer's bank account.
  - `bankName` string: Name of the bank.
  - `accountNumber` string: Account number of the customer's bank account.
  - `bankCode` string: Bank code of the customer bank's account.
  - `iBAN` string: International bank account number of the customer's bank account.
  - `bIC` string: Bank identification code of the customer's bank account.

## Response `201`

The created bank account of the customer.

- JTLWawiRestContractsModelsV1CustomerCustomerBankAccount: Model Class: CustomerBankAccount
  - `id` string, uuid
  - `accountHolder` string: Name of the account holder of the customer's bank account.
  - `bankName` string: Name of the bank.
  - `accountNumber` string: Account number of the customer's bank account.
  - `bankCode` string: Bank code of the customer bank's account.
  - `iBAN` string: International bank account number of the customer's bank account.
  - `bIC` string: Bank identification code of the customer's bank account.

## Other responses

- `400`: The sent data is invalid.
- `401`
- `402`: No licence available or the app has not been authorised by JTL.

---

[API](https://skmtc.dev/jtl-software/apis/scx-authentication-api.md) - [All operations](https://skmtc.dev/jtl-software/apis/scx-authentication-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jtl-software/apis/scx-authentication-api/revisions/f979b1ea6951?raw)