---
title: "Changes to Initiate Payee Creation"
method: POST
path: "/v4/payees"
---

# Changes to Initiate Payee Creation

`POST /v4/payees`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 50 revisions.

- **2026-07-13** `05c3f09fc50a` — 3 breaking, 4 info
- **2022-06-27** `1e7a1734a45c` — 7 breaking, 1 warning
- **2022-04-07** `da77064fe233` — 1005 breaking, 1 warning
- **2020-09-25** `dd71433847a6` — 26 breaking, 26 info
- **2020-08-13** `75bb7af5ae63` — 1 info
- **2019-07-15** `ced8e167a97c` — 1 breaking

## Changes

- **2026-07-13** `05c3f09fc50a` — 3 breaking, 4 info
  - the `file/items/addressZipOrPostcode` request property's maxLength was decreased to `20` (media type: multipart/form-data)
  - the `payees/items/address/zipOrPostcode` request property's maxLength was decreased to `20` (media type: application/json)
  - the `file/items/addressZipOrPostcode` request property's minLength was increased from `1` to `2` (media type: multipart/form-data)
  - the request property `file/items/addressZipOrPostcode` became optional (media type: multipart/form-data)
  - the `file/items/individualNationalIdentification` request property's minLength was decreased from `6` to `4` (media type: multipart/form-data)
  - the `payees/items/company/taxId` request property's minLength was decreased from `6` to `4` (media type: application/json)
  - the `payees/items/individual/nationalIdentification` request property's minLength was decreased from `6` to `4` (media type: application/json)
- **2022-06-27** `1e7a1734a45c` — 7 breaking, 1 warning
  - removed the enum value `ACCEPTED` of the request property `payees/items/payorRefs/items/invitationStatus` (media type: application/json)
  - removed the enum value `DECLINED` of the request property `payees/items/payorRefs/items/invitationStatus` (media type: application/json)
  - removed the enum value `EUR` of the request property `file/items/paymentChannelCurrency` (media type: multipart/form-data)
  - removed the enum value `GBP` of the request property `file/items/paymentChannelCurrency` (media type: multipart/form-data)
  - removed the enum value `PENDING` of the request property `payees/items/payorRefs/items/invitationStatus` (media type: application/json)
  - removed the enum value `USD` of the request property `file/items/paymentChannelCurrency` (media type: multipart/form-data)
  - the `file/items/paymentChannelCurrency` request property's minLength was increased from `0` to `3` (media type: multipart/form-data)
  - the `file/items/paymentChannelCurrency` request property's maxLength was set to `3` (media type: multipart/form-data)
- **2022-04-07** `da77064fe233` — 1005 breaking, 1 warning
  - removed the enum value `AD` of the request property `file/items/addressCountry` (media type: multipart/form-data)
  - removed the enum value `AD` of the request property `file/items/paymentChannelCountryCode` (media type: multipart/form-data)
  - removed the enum value `AD` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AD` of the request property `payees/items/paymentChannel/countryCode` (media type: application/json)
  - removed the enum value `AE` of the request property `file/items/addressCountry` (media type: multipart/form-data)
  - removed the enum value `AE` of the request property `file/items/paymentChannelCountryCode` (media type: multipart/form-data)
  - removed the enum value `AE` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AE` of the request property `payees/items/paymentChannel/countryCode` (media type: application/json)
  - removed the enum value `AF` of the request property `file/items/addressCountry` (media type: multipart/form-data)
  - removed the enum value `AF` of the request property `file/items/paymentChannelCountryCode` (media type: multipart/form-data)
  - removed the enum value `AF` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AF` of the request property `payees/items/paymentChannel/countryCode` (media type: application/json)
  - removed the enum value `AG` of the request property `file/items/addressCountry` (media type: multipart/form-data)
  - removed the enum value `AG` of the request property `file/items/paymentChannelCountryCode` (media type: multipart/form-data)
  - removed the enum value `AG` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AG` of the request property `payees/items/paymentChannel/countryCode` (media type: application/json)
  - removed the enum value `AI` of the request property `file/items/addressCountry` (media type: multipart/form-data)
  - removed the enum value `AI` of the request property `file/items/paymentChannelCountryCode` (media type: multipart/form-data)
  - removed the enum value `AI` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AI` of the request property `payees/items/paymentChannel/countryCode` (media type: application/json)
  - removed the enum value `AL` of the request property `file/items/addressCountry` (media type: multipart/form-data)
  - removed the enum value `AL` of the request property `file/items/paymentChannelCountryCode` (media type: multipart/form-data)
  - removed the enum value `AL` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AL` of the request property `payees/items/paymentChannel/countryCode` (media type: application/json)
  - removed the enum value `AM` of the request property `file/items/addressCountry` (media type: multipart/form-data)
  - removed the enum value `AM` of the request property `file/items/paymentChannelCountryCode` (media type: multipart/form-data)
  - removed the enum value `AM` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AM` of the request property `payees/items/paymentChannel/countryCode` (media type: application/json)
  - removed the enum value `AO` of the request property `file/items/addressCountry` (media type: multipart/form-data)
  - removed the enum value `AO` of the request property `file/items/paymentChannelCountryCode` (media type: multipart/form-data)
  - removed the enum value `AO` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AO` of the request property `payees/items/paymentChannel/countryCode` (media type: application/json)
  - removed the enum value `AQ` of the request property `file/items/addressCountry` (media type: multipart/form-data)
  - removed the enum value `AQ` of the request property `file/items/paymentChannelCountryCode` (media type: multipart/form-data)
  - removed the enum value `AQ` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AQ` of the request property `payees/items/paymentChannel/countryCode` (media type: application/json)
  - removed the enum value `AR` of the request property `file/items/addressCountry` (media type: multipart/form-data)
  - removed the enum value `AR` of the request property `file/items/paymentChannelCountryCode` (media type: multipart/form-data)
  - removed the enum value `AR` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AR` of the request property `payees/items/paymentChannel/countryCode` (media type: application/json)
  - …966 more
- **2020-09-25** `dd71433847a6` — 26 breaking, 26 info
  - removed the enum value `AR` of the request property `file/items/payeeLanguage` (media type: multipart/form-data)
  - removed the enum value `AR` of the request property `payees/items/language` (media type: application/json)
  - removed the enum value `EN` of the request property `file/items/payeeLanguage` (media type: multipart/form-data)
  - removed the enum value `EN` of the request property `payees/items/language` (media type: application/json)
  - removed the enum value `ES` of the request property `file/items/payeeLanguage` (media type: multipart/form-data)
  - removed the enum value `ES` of the request property `payees/items/language` (media type: application/json)
  - removed the enum value `FR` of the request property `file/items/payeeLanguage` (media type: multipart/form-data)
  - removed the enum value `FR` of the request property `payees/items/language` (media type: application/json)
  - removed the enum value `HE` of the request property `file/items/payeeLanguage` (media type: multipart/form-data)
  - removed the enum value `HE` of the request property `payees/items/language` (media type: application/json)
  - removed the enum value `HI` of the request property `file/items/payeeLanguage` (media type: multipart/form-data)
  - removed the enum value `HI` of the request property `payees/items/language` (media type: application/json)
  - removed the enum value `JA` of the request property `file/items/payeeLanguage` (media type: multipart/form-data)
  - removed the enum value `JA` of the request property `payees/items/language` (media type: application/json)
  - removed the enum value `PT` of the request property `file/items/payeeLanguage` (media type: multipart/form-data)
  - removed the enum value `PT` of the request property `payees/items/language` (media type: application/json)
  - removed the enum value `RU` of the request property `file/items/payeeLanguage` (media type: multipart/form-data)
  - removed the enum value `RU` of the request property `payees/items/language` (media type: application/json)
  - removed the enum value `UR` of the request property `file/items/payeeLanguage` (media type: multipart/form-data)
  - removed the enum value `UR` of the request property `payees/items/language` (media type: application/json)
  - removed the enum value `ZH` of the request property `file/items/payeeLanguage` (media type: multipart/form-data)
  - removed the enum value `ZH` of the request property `payees/items/language` (media type: application/json)
  - the `errors/items/` response's property type/format changed from ``/`` to `object`/`` for status `400`
  - the `errors/items/` response's property type/format changed from ``/`` to `object`/`` for status `401`
  - the `errors/items/` response's property type/format changed from ``/`` to `object`/`` for status `403`
  - the `errors/items/` response's property type/format changed from ``/`` to `object`/`` for status `404`
  - added the new optional request property `payees/items/payorRefs/items/payableIssues` (media type: application/json)
  - added the new optional request property `payees/items/payorRefs/items/payableStatus` (media type: application/json)
  - added the optional property `errors/items/errorCode` to the response with the `400` status
  - added the optional property `errors/items/errorCode` to the response with the `401` status
  - added the optional property `errors/items/errorCode` to the response with the `403` status
  - added the optional property `errors/items/errorCode` to the response with the `404` status
  - added the optional property `errors/items/errorData` to the response with the `400` status
  - added the optional property `errors/items/errorData` to the response with the `401` status
  - added the optional property `errors/items/errorData` to the response with the `403` status
  - added the optional property `errors/items/errorData` to the response with the `404` status
  - added the optional property `errors/items/localisationDetails` to the response with the `400` status
  - added the optional property `errors/items/localisationDetails` to the response with the `401` status
  - added the optional property `errors/items/localisationDetails` to the response with the `403` status
  - added the optional property `errors/items/localisationDetails` to the response with the `404` status
  - …12 more
- **2020-08-13** `75bb7af5ae63` — 1 info
  - endpoint added
- **2019-07-15** `ced8e167a97c` — 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis/docs/v4/payees/post.md) · [API](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis.md) · [Page](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis/changes/v4/payees/post)