---
title: "POST /bankAccount"
method: POST
path: "/bankAccount"
tags: ["bankAccount"]
---

# POST /bankAccount

`POST /bankAccount`

## Request

- Base URL: `https://www.weclapp.com/api/nullapi/v2`
- URL: `https://www.weclapp.com/api/nullapi/v2/bankAccount`
- Auth: API key in header `AuthenticationToken`
- TypeScript: <https://skmtc.dev/weclapp/apis/weclapp-api/docs/bankAccount/post.ts> (a function with typed inputs; its response is checked against the schema)

create a bankAccount

## Query parameters

- `dryRun` boolean

## Request body

- BankAccount
  - `id` string
  - `version` string
  - `accountHolder` string
  - `accountId` string
  - `accountNumber` string
  - `active` boolean
  - `autoSync` boolean
  - `automaticProcessing` 'BOOK' | 'CLEAR' | 'NONE' | 'PROCESS'
  - `balance` string, number
  - `bankCode` string
  - `connectionFailure` string
  - `createdDate` integer
  - `creditInstitute` string
  - `creditInstituteCity` string
  - `creditInstituteStreet` string
  - `creditInstituteZip` string
  - `creditLine` string, number
  - `currencyId` string
  - `differentSepaCreditorIdentifier` string
  - `enabledForElectronicPaymentTransactions` boolean
  - `iban` string
  - `incidentalCostsOfMonetaryTrafficAccountId` string
  - `incidentalCostsOfMonetaryTrafficTaxId` string
  - `lastDownload` integer
  - `lastModifiedDate` integer
  - `paymentProviderConnectionId` string
  - `primary` boolean
  - `qrIban` string
  - `qrIdentifier` string
  - `swiftBic` string

## Response `201`

bankAccount create response

- BankAccount
  - `id` string
  - `version` string
  - `accountHolder` string
  - `accountId` string
  - `accountNumber` string
  - `active` boolean
  - `autoSync` boolean
  - `automaticProcessing` 'BOOK' | 'CLEAR' | 'NONE' | 'PROCESS'
  - `balance` string, number
  - `bankCode` string
  - `connectionFailure` string
  - `createdDate` integer
  - `creditInstitute` string
  - `creditInstituteCity` string
  - `creditInstituteStreet` string
  - `creditInstituteZip` string
  - `creditLine` string, number
  - `currencyId` string
  - `differentSepaCreditorIdentifier` string
  - `enabledForElectronicPaymentTransactions` boolean
  - `iban` string
  - `incidentalCostsOfMonetaryTrafficAccountId` string
  - `incidentalCostsOfMonetaryTrafficTaxId` string
  - `lastDownload` integer
  - `lastModifiedDate` integer
  - `paymentProviderConnectionId` string
  - `primary` boolean
  - `qrIban` string
  - `qrIdentifier` string
  - `swiftBic` string

## Other responses

- `default`: error response

## Changes

- **2026-11-07** `0e021229755d`: 1 info
  - added the new optional `query` request parameter `dryRun`
- **2022-06-29** `a926aad6dc0c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/weclapp/apis/weclapp-api/changes/bankAccount/post.md)

---

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