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

# Changes to Initiate Payee Creation

`POST /v3/payees`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 11 of 50 revisions.

- **2026-07-13** `05c3f09fc50a` — 3 breaking, 4 info
- **2022-06-27** `1e7a1734a45c` — 258 breaking, 1 warning
- **2022-04-07** `da77064fe233` — 755 breaking, 1 warning, 1 info
- **2020-09-25** `dd71433847a6` — 26 breaking, 26 info
- **2020-08-13** `75bb7af5ae63` — 1 breaking, 2 info
- **2020-06-24** `aded220b0d7b` — 3 breaking, 1 warning, 1 info
- **2020-02-27** `7c8cfeb59952` — 10 breaking, 1011 info
- **2020-02-03** `68f50053dc40` — 1012 breaking, 3 warning, 1 info
- **2020-01-28** `1b2abf26b5d6` — 3 breaking, 1 warning, 15 info
- **2019-11-25** `86699f3efd3a` — 1 info
- **2019-07-15** `ced8e167a97c` — 1 info

## 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` — 258 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 `AD` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AE` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AF` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AG` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AI` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AL` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AM` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AO` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AQ` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AR` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AS` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AT` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AU` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AW` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AX` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `AZ` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `BA` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `BB` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `BD` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `BE` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `BF` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `BG` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `BH` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `BI` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `BJ` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `BL` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `BM` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `BN` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `BO` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `BQ` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `BR` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `BS` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `BT` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `BV` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `BW` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `BY` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `BZ` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `CA` of the request property `payees/items/address/country` (media type: application/json)
  - removed the enum value `CC` of the request property `payees/items/address/country` (media type: application/json)
  - …219 more
- **2022-04-07** `da77064fe233` — 755 breaking, 1 warning, 1 info
  - 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/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/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/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/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/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/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/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/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/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/paymentChannel/countryCode` (media type: application/json)
  - removed the enum value `AS` of the request property `file/items/addressCountry` (media type: multipart/form-data)
  - removed the enum value `AS` of the request property `file/items/paymentChannelCountryCode` (media type: multipart/form-data)
  - removed the enum value `AS` of the request property `payees/items/paymentChannel/countryCode` (media type: application/json)
  - removed the enum value `AT` of the request property `file/items/addressCountry` (media type: multipart/form-data)
  - removed the enum value `AT` of the request property `file/items/paymentChannelCountryCode` (media type: multipart/form-data)
  - removed the enum value `AT` of the request property `payees/items/paymentChannel/countryCode` (media type: application/json)
  - removed the enum value `AU` of the request property `file/items/addressCountry` (media type: multipart/form-data)
  - removed the enum value `AU` of the request property `file/items/paymentChannelCountryCode` (media type: multipart/form-data)
  - removed the enum value `AU` of the request property `payees/items/paymentChannel/countryCode` (media type: application/json)
  - removed the enum value `AW` of the request property `file/items/addressCountry` (media type: multipart/form-data)
  - …717 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 breaking, 2 info
  - the `payees/items/company/name` request property's minLength was increased from `1` to `3`
  - endpoint deprecated
  - removed the non-success response with the status `409`
- **2020-06-24** `aded220b0d7b` — 3 breaking, 1 warning, 1 info
  - the `payees/items/company/taxId` request property's minLength was increased from `0` to `6`
  - the response's body type/format changed from `object`/`` to ``/`` for status `404`
  - the `errors/items/` response's property type/format changed from `object`/`` to ``/`` for status `404`
  - the `payees/items/company/taxId` request property's maxLength was set to `30`
  - removed the pattern `^[\d]{9}$` from the request property `payees/items/company/taxId`
- **2020-02-27** `7c8cfeb59952` — 10 breaking, 1011 info
  - request property `file/items/addressCountry` was restricted to a list of enum values (media type: multipart/form-data)
  - request property `file/items/paymentChannelCountryCode` was restricted to a list of enum values (media type: multipart/form-data)
  - request property `file/items/paymentChannelCurrency` was restricted to a list of enum values (media type: multipart/form-data)
  - request property `payees/items/address/country` was restricted to a list of enum values (media type: application/json)
  - request property `payees/items/paymentChannel/countryCode` was restricted to a list of enum values (media type: application/json)
  - request property `payees/items/paymentChannel/currency` was restricted to a list of enum values (media type: application/json)
  - added the pattern `^[\d]{9}$` to the request property `payees/items/company/taxId` (media type: application/json)
  - the `payees/items/individual/name` request property type/format changed from `object`/`` to ``/`` (media type: application/json)
  - the response's body type/format changed from `object`/`` to ``/`` for status `409`
  - the `errors/items/` response's property type/format changed from `object`/`` to ``/`` for status `409`
  - added the new `AD` enum value to the request property `file/items/addressCountry` (media type: multipart/form-data)
  - added the new `AD` enum value to the request property `file/items/paymentChannelCountryCode` (media type: multipart/form-data)
  - added the new `AD` enum value to the request property `payees/items/address/country` (media type: application/json)
  - added the new `AD` enum value to the request property `payees/items/paymentChannel/countryCode` (media type: application/json)
  - added the new `AE` enum value to the request property `file/items/addressCountry` (media type: multipart/form-data)
  - added the new `AE` enum value to the request property `file/items/paymentChannelCountryCode` (media type: multipart/form-data)
  - added the new `AE` enum value to the request property `payees/items/address/country` (media type: application/json)
  - added the new `AE` enum value to the request property `payees/items/paymentChannel/countryCode` (media type: application/json)
  - added the new `AF` enum value to the request property `file/items/addressCountry` (media type: multipart/form-data)
  - added the new `AF` enum value to the request property `file/items/paymentChannelCountryCode` (media type: multipart/form-data)
  - added the new `AF` enum value to the request property `payees/items/address/country` (media type: application/json)
  - added the new `AF` enum value to the request property `payees/items/paymentChannel/countryCode` (media type: application/json)
  - added the new `AG` enum value to the request property `file/items/addressCountry` (media type: multipart/form-data)
  - added the new `AG` enum value to the request property `file/items/paymentChannelCountryCode` (media type: multipart/form-data)
  - added the new `AG` enum value to the request property `payees/items/address/country` (media type: application/json)
  - added the new `AG` enum value to the request property `payees/items/paymentChannel/countryCode` (media type: application/json)
  - added the new `AI` enum value to the request property `file/items/addressCountry` (media type: multipart/form-data)
  - added the new `AI` enum value to the request property `file/items/paymentChannelCountryCode` (media type: multipart/form-data)
  - added the new `AI` enum value to the request property `payees/items/address/country` (media type: application/json)
  - added the new `AI` enum value to the request property `payees/items/paymentChannel/countryCode` (media type: application/json)
  - added the new `AL` enum value to the request property `file/items/addressCountry` (media type: multipart/form-data)
  - added the new `AL` enum value to the request property `file/items/paymentChannelCountryCode` (media type: multipart/form-data)
  - added the new `AL` enum value to the request property `payees/items/address/country` (media type: application/json)
  - added the new `AL` enum value to the request property `payees/items/paymentChannel/countryCode` (media type: application/json)
  - added the new `AM` enum value to the request property `file/items/addressCountry` (media type: multipart/form-data)
  - added the new `AM` enum value to the request property `file/items/paymentChannelCountryCode` (media type: multipart/form-data)
  - added the new `AM` enum value to the request property `payees/items/address/country` (media type: application/json)
  - added the new `AM` enum value to the request property `payees/items/paymentChannel/countryCode` (media type: application/json)
  - added the new `AO` enum value to the request property `file/items/addressCountry` (media type: multipart/form-data)
  - added the new `AO` enum value to the request property `file/items/paymentChannelCountryCode` (media type: multipart/form-data)
  - …981 more
- **2020-02-03** `68f50053dc40` — 1012 breaking, 3 warning, 1 info
  - 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)
  - …976 more
- **2020-01-28** `1b2abf26b5d6` — 3 breaking, 1 warning, 15 info
  - request property `payees/items/payorRefs/items/invitationStatus` was restricted to a list of enum values (media type: application/json)
  - the `file/items/companyEIN` request property's minLength was increased from `0` to `6` (media type: multipart/form-data)
  - the `rejectedCsvRows/items/` response's property type/format changed from `string`/`` to ``/`` for status `201`
  - the `file/items/companyEIN` request property's maxLength was set to `30` (media type: multipart/form-data)
  - added the new optional request property `payees/items/payorRefs/items/invitationStatusTimestamp` (media type: application/json)
  - added the new optional request property `payees/items/payorRefs/items/paymentChannelId` (media type: application/json)
  - request body became optional
  - added the new `ACCEPTED` enum value to the request property `payees/items/payorRefs/items/invitationStatus` (media type: application/json)
  - added the new `DECLINED` enum value to the request property `payees/items/payorRefs/items/invitationStatus` (media type: application/json)
  - added the new `PENDING` enum value to the request property `payees/items/payorRefs/items/invitationStatus` (media type: application/json)
  - removed the pattern `[\\d]{9}` from the request property `file/items/companyEIN` (media type: multipart/form-data)
  - added the media type `application/json` for the 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 `409`
  - added the optional property `rejectedCsvRows/items/lineNumber` to the response with the `201` status
  - added the optional property `rejectedCsvRows/items/message` to the response with the `201` status
  - added the optional property `rejectedCsvRows/items/rejectedContent` to the response with the `201` status
- **2019-11-25** `86699f3efd3a` — 1 info
  - endpoint added
- **2019-07-15** `ced8e167a97c` — 1 info
  - api path removed with deprecation

---

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