---
title: "Create a bank feed"
method: POST
path: "/accounting/bankFeeds"
tags: ["Bank Feeds"]
---

# Create a bank feed

`POST /accounting/bankFeeds`

## Request

- Base URL: `https://api.clearbooks.co.uk/v1`
- URL: `https://api.clearbooks.co.uk/v1/accounting/bankFeeds`
- Auth: OAuth 2 (authorization code, authorization URL `https://secure.clearbooks.co.uk/account/action/oauth/`, token URL `https://api.clearbooks.co.uk/oauth/token`, scopes: `accounting.bank_feeds:write`)

### Linking to an existing bank account

A bank feed can be created for an existing Clear Books bank account in one of two ways:

1. By specifying an `accountId` returned from one of the bank accounts endpoints.

2. By providing and `accountNumber` and `sortCode` that match an account which already exists in Clear Books.

### Creating a new bank account

If a bank account does not already exist in Clear Books for the bank feed you wish to create, then you must provide
enough information to allow us to create an account for you. The required fields in this case are `name`,
`accountNumber` and `sortCode`.

If an existing bank account that matches this information is found, then it will be used and no extra account will be created.

## Headers

- `X-Business-ID` integer

## Request body

- object
  - `items` BankFeed[]
    - `id` string
    - `name` string
    - `accountNumber` string
    - `sortCode` string
    - `iban` string
    - `swift` string
    - `currency` string: ISO 4217 currency code. If omitted the home currency of the account is used.
    - `accountToken` string: An optional third-party identifier for the source of this feed
    - `accountId` integer

## Response `201`

Bank feed created

- object
  - `items` BankFeed[]
    - `id` string
    - `name` string
    - `accountNumber` string
    - `sortCode` string
    - `iban` string
    - `swift` string
    - `currency` string: ISO 4217 currency code. If omitted the home currency of the account is used.
    - `accountToken` string: An optional third-party identifier for the source of this feed
    - `accountId` integer

## Other responses

- `400`: The request was malformed or missing required parameters
- `401`: A valid authorisation token is required to perform this action
- `403`: No permission was granted to perform this action
- `422`: The request was well formed, but could not be actioned due to business rule constraints
- `429`: The application is making too many requests and has been rate limited

---

[API](https://skmtc.dev/clearbooks/apis/clear-books-api.md) · [All operations](https://skmtc.dev/clearbooks/apis/clear-books-api/llms.txt) · [OpenAPI document](https://skmtc.dev/clearbooks/apis/clear-books-api/revisions/5e46fa6863a7?raw)