---
title: "Changes to POST /v1/customers/{customer_id}/recipients/{recipient_id}/bank_accounts"
method: POST
path: "/v1/customers/{customer_id}/recipients/{recipient_id}/bank_accounts"
---

# Changes to POST /v1/customers/{customer_id}/recipients/{recipient_id}/bank_accounts

`POST /v1/customers/{customer_id}/recipients/{recipient_id}/bank_accounts`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `d213edbaccb6`: 6 breaking, 6 warning, 8 info

## Changes

- **2026-11-03** `d213edbaccb6`: 6 breaking, 6 warning, 8 info
  - added the new required `header` request parameter `Idempotency-Key`
  - the `account_number` request property's minLength was increased from `0` to `1`
  - the response property `allOf[subschema #1]/institution_clearing_code` became nullable for the status `201`
  - the response property `allOf[subschema #1]/nickname` became nullable for the status `201`
  - the response property `allOf[subschema #1]/reference_code` became nullable for the status `201`
  - the response property `allOf[subschema #1]/institution_id` became optional for the status `201`
  - the `account_number` request property's maxLength was set to `64`
  - the `institution_clearing_code` request property's maxLength was set to `32`
  - the `institution_id` request property's maxLength was set to `64`
  - the `intermediary_bank/oneOf[#/components/schemas/IntermediaryBank]/institution_id` request property's maxLength was set to `64`
  - the `nickname` request property's maxLength was set to `64`
  - added the new `BES` enum value to the `allOf[subschema #1]/country_code` response property for the response status `201`
  - api tag `crate::web::openapi::recipients` added
  - api tag `Recipients (Send to Others)` removed
  - added the new optional request property `institution_name`
  - the request property `institution_id` became nullable
  - the request property `institution_id` became optional
  - added the new `BES` enum value to the request property `country_code`
  - added the optional property `allOf[subschema #1]/failure_reason` to the response with the `201` status
  - added the optional property `allOf[subschema #1]/recipient/oneOf[#/components/schemas/RecipientResponse]/action_required` to the response with the `201` status

---

[Operation](https://skmtc.dev/1money/apis/1money-openapi/docs/v1/customers/:customer_id/recipients/:recipient_id/bank_accounts/post.md) - [API](https://skmtc.dev/1money/apis/1money-openapi.md) - [Page](https://skmtc.dev/1money/apis/1money-openapi/changes/v1/customers/:customer_id/recipients/:recipient_id/bank_accounts/post)