---
title: "POST /invoicing/bank-accounts"
method: POST
path: "/invoicing/bank-accounts"
tags: ["Invoicing Settings"]
---

# POST /invoicing/bank-accounts

`POST /invoicing/bank-accounts`

## Request

- Base URL: `https://developer.meetergo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.meetergo.com/invoicing/bank-accounts`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - API key in header `x-meetergo-api-user-id`

## Request body

- CreateBankAccountDto
  - `label` string, required
  - `iban` string, required
  - `bic` string, nullable: The three optional details below accept null as well as a value: null is how an edit clears one. Without it there is no way to express "this account no longer has a BIC" or "this account is no longer tied to a currency" — an omitted field means "leave alone" to the update path, so a cleared input would save successfully and change nothing.
  - `bankName` string, nullable
  - `currency` string, nullable: ISO 4217. Null for an account usable with any currency.
  - `isDefault` boolean

## Response `201`

- InvoicingBankAccount
  - `id` string, required
  - `label` string, required: What the seller calls it, e.g. "CHF Konto" or "Hauptkonto".
  - `iban` string, required
  - `bic` string, nullable
  - `bankName` string, nullable
  - `currency` string, nullable: ISO 4217 the account is held in. Null means "use for anything" — the point of the feature is matching an invoice's currency to an account, but a seller with one account per currency plus a catch-all should not be forced to label the catch-all.
  - `isDefault` boolean, required: Used when a document names no account and no currency match is found.
  - `companyId` string, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400`: The request did not validate. `message` lists the constraints that failed.
- `401`: Missing, malformed, or expired credentials.
- `403`: Authenticated, but not allowed: the plan does not include this feature, or the token is scoped away from it.
- `429`: Rate limited. Back off and retry.

---

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