---
title: "Create bank account"
method: POST
path: "/companies/{companyId}/connections/{connectionId}/push/bankAccounts"
tags: ["Bank accounts"]
---

# Create bank account

`POST /companies/{companyId}/connections/{connectionId}/push/bankAccounts`

## Request

- Base URL: `https://api.codat.io`
- URL: `https://api.codat.io/companies/{companyId}/connections/{connectionId}/push/bankAccounts`
- Auth: API key in header `Authorization`

The *Create bank account* endpoint creates a new [bank account](https://docs.codat.io/sync-for-payables-api#/schemas/BankAccount) for a given company's connection.

[Bank accounts](https://docs.codat.io/sync-for-payables-api#/schemas/BankAccount) are financial accounts maintained by a bank or other financial institution.

**Integration-specific behavior**

Required data may vary by integration. To see what data to post, first call [Get create/update bank account model](https://docs.codat.io/sync-for-payables-api#/operations/get-create-update-bankAccounts-model).

## Query parameters

- `timeoutInMinutes` integer

## Request body

- BankAccountPrototype (unresolved $ref)

## Response `200`

Success

- BankAccountCreateResponse (unresolved $ref)

## Other responses

- `400`: The request made is not valid.
- `401`: Your API request was not properly authorized.
- `402`: An account limit has been exceeded. The type of limit is described in the error property: - You have exceeded the 50-company limit that applies to a Free plan. Delete any companies you no longer need and retry the request. - The requested sync schedule is not allowed. You requested an hourly sync schedule but this functionality is not included in the Free plan. - Your Free account is older than 365 days and has expired. Contact support@codat.io.
- `403`: You are using an outdated API key or a key not associated with that resource.
- `404`: One or more of the resources you referenced could not be found. This might be because your company or data connection id is wrong, or was already deleted.
- `429`: Too many requests were made in a given amount of time. Wait a short period and then try again.
- `500`: There is a problem with our server. Please try again later.
- `503`: The Codat API is temporarily offline for maintenance. Please try again later.

## Changes

- **2024-09-10** (v1) `5a2a77c169ea`: 4 info
  - added `#/components/schemas/created` to the `allOf[subschema #1]/data/allOf[subschema #1: Accounting: Bank account]/allOf[subschema #4: Modified dates]/allOf[subschema #1: ModifiedDate]/modifiedDate` response property `allOf` list for the response status `200`
  - added `#/components/schemas/created` to the `allOf[subschema #1]/data/allOf[subschema #1: Accounting: Bank account]/allOf[subschema #4: Modified dates]/allOf[subschema #2: Source Modified Date]/sourceModifiedDate` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/created` from the `allOf[subschema #1]/data/allOf[subschema #1: Accounting: Bank account]/allOf[subschema #4: Modified dates]/allOf[subschema #1: ModifiedDate]/modifiedDate` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/created` from the `allOf[subschema #1]/data/allOf[subschema #1: Accounting: Bank account]/allOf[subschema #4: Modified dates]/allOf[subschema #2: Source Modified Date]/sourceModifiedDate` response property `allOf` list for the response status `200`
- …earlier changes not shown

[Operation history](https://skmtc.dev/codatio/apis/sync-for-payables/changes/companies/:companyId/connections/:connectionId/push/bankAccounts/post.md)

---

[API](https://skmtc.dev/codatio/apis/sync-for-payables.md) - [All operations](https://skmtc.dev/codatio/apis/sync-for-payables/llms.txt) - [OpenAPI document](https://skmtc.dev/codatio/apis/sync-for-payables/revisions/06163dffa75f?raw)