---
title: "Changes to Create beneficiary"
method: POST
path: "/v1/transfer/beneficiaries"
---

# Changes to Create beneficiary

`POST /v1/transfer/beneficiaries`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `4aed77604588`: 2 breaking, 12 info

## Changes

- **2026-11-03** `4aed77604588`: 2 breaking, 12 info
  - the request property `bvn` became required
  - the request property `description` became required
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - added the new `USD` enum value to the request property `currency`
  - added the new `XOF` enum value to the request property `currency`
  - added the new `ZAR` enum value to the request property `currency`
  - added `#/components/schemas/SuccessResponseDto, subschema #2` to the response body `allOf` list for the response status `201`
  - removed `#/components/schemas/GenericResponse` from the response body `allOf` list for the response status `201`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the non-success response with the status `422`
  - added the non-success response with the status `500`

---

[Operation](https://skmtc.dev/kyshi/apis/kyshi-mor-public-api/docs/v1/transfer/beneficiaries/post.md) - [API](https://skmtc.dev/kyshi/apis/kyshi-mor-public-api.md) - [Page](https://skmtc.dev/kyshi/apis/kyshi-mor-public-api/changes/v1/transfer/beneficiaries/post)