---
title: "Changes to Create payout"
method: POST
path: "/v1/payouts"
---

# Changes to Create payout

`POST /v1/payouts`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 16 of 94 revisions.

- **2026-10-16** `f7ded6c181ab`: 1 info
- **2026-08-31** `e0010b51834a`: 2 info
- **2026-08-28** `5f67183b67c6`: 1 info
- **2026-08-27** `4549ed68144b`: 1 breaking, 4 warning
- **2026-08-27** `8e304f78f67e`: 1 breaking, 9 info
- **2026-08-21** `79d607871de9`: 12 breaking, 7 warning, 25 info
- **2026-08-19** `3d21138daf4c`: 3 info
- **2026-08-18** `37109d1ed976`: 2 breaking, 5 info
- **2026-08-17** `3ed0a0aba68b`: 4 breaking, 4 info
- **2026-07-27** `1d6de495a31d`: 1 breaking
- **2026-07-13** `d92a4abea6c4`: 3 warning, 3 info
- **2026-06-17** `74deb4d45f9f`: 1 breaking, 6 warning, 2 info
- **2026-04-29** `87ee55c3e7c4`: 1 breaking
- **2026-04-24** `75f9878ced37`: 4 warning, 1 info
- **2026-04-22** `7e26180bf667`: 2 breaking, 2 info
- **2026-03-26** `46f498194a49`: 1 info

## Changes

- **2026-10-16** `f7ded6c181ab`: 1 info
  - endpoint added
- **2026-08-31** `e0010b51834a`: 2 info
  - added `#/components/schemas/BicDestination` to the `destination` request property `anyOf` list
  - the `rail` request property default value `swift` was added
- **2026-08-28** `5f67183b67c6`: 1 info
  - added the required property `tracking_id` to the response with the `200` status
- **2026-08-27** `4549ed68144b`: 1 breaking, 4 warning
  - added the new required request property `destination`
  - removed the request property `counterparty`
  - removed the request property `counterparty_id`
  - removed the request property `currency`
  - removed the request property `rail`
- **2026-08-27** `8e304f78f67e`: 1 breaking, 9 info
  - removed `#/components/schemas/IbanFinancialAddress` from the `counterparty/financial_address` request property `anyOf` list
  - added `#/components/schemas/IbanFinancialAddressRequest` to the `counterparty/financial_address` request property `anyOf` list
  - the request property `counterparty` became optional
  - the request property `counterparty/physical_address` became optional
  - the request property `counterparty/physical_address/line_2` became optional
  - the request property `counterparty/physical_address/state` became optional
  - the request property `counterparty_id` became optional
  - the request property `metadata` became optional
  - the request property `rail` became optional
  - the request property `unstructured_remittance_information` became optional
- **2026-08-21** `79d607871de9`: 12 breaking, 7 warning, 25 info
  - added the new required request property `account_id`
  - added the new required request property `counterparty`
  - added the new required request property `counterparty_id`
  - added the new required request property `unstructured_remittance_information`
  - the request property `metadata` became required
  - the request property `rail` became required
  - added 'propertyNames' constraint to the request property `metadata`
  - removed the required property `created_at` from the response with the `200` status
  - removed the required property `destination` from the response with the `200` status
  - removed the required property `reference` from the response with the `200` status
  - removed the required property `source_account_id` from the response with the `200` status
  - removed the required property `updated_at` from the response with the `200` status
  - removed the request property `destination`
  - removed the request property `reference`
  - removed the request property `source_account_id`
  - added the new `initiated` enum value to the `status` response property for the response status `200`
  - added the new `invalid_routing_number` enum value to the `failure/code` response property for the response status `200`
  - added the new `sent` enum value to the `status` response property for the response status `200`
  - added the new `submitted` enum value to the `status` response property for the response status `200`
  - the request property `metadata` became nullable
  - the request property `rail` became nullable
  - added the new `ach` enum value to the request property `rail`
  - added the new `bitcoin` enum value to the request property `rail`
  - added the new `bitcoin_testnet4` enum value to the request property `rail`
  - added the new `ethereum` enum value to the request property `rail`
  - added the new `ethereum_sepolia` enum value to the request property `rail`
  - added the new `fedwire` enum value to the request property `rail`
  - added the new `internal` enum value to the request property `rail`
  - added the new `polygon` enum value to the request property `rail`
  - added the new `polygon_amoy` enum value to the request property `rail`
  - added the new `solana` enum value to the request property `rail`
  - added the new `solana_devnet` enum value to the request property `rail`
  - added the new `swift` enum value to the request property `rail`
  - added the new `target` enum value to the request property `rail`
  - added the new `undefined` enum value to the request property `rail`
  - removed the `paid` enum value from the `status` response property for the response status `200`
  - removed the `pending` enum value from the `status` response property for the response status `200`
  - added the required property `account_id` to the response with the `200` status
  - added the required property `counterparty_id` to the response with the `200` status
  - added the required property `initiated_at` to the response with the `200` status
  - …4 more
- **2026-08-19** `3d21138daf4c`: 3 info
  - removed the pattern `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$` from the request property `source_account_id`
  - the `created_at` response's property pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$` was removed for the status `200`
  - the `updated_at` response's property pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$` was removed for the status `200`
- **2026-08-18** `37109d1ed976`: 2 breaking, 5 info
  - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the `destination` request property `oneOf` list
  - added the pattern `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$` to the request property `source_account_id`
  - added `#/components/schemas/SortCodeFinancialAddress, #/components/schemas/AbaFinancialAddress, #/components/schemas/CryptoWalletFinancialAddress, subschema #1: IBAN` to the `destination` request property `anyOf` list
  - added `#/components/schemas/IbanFinancialAddress, #/components/schemas/SortCodeFinancialAddress, #/components/schemas/AbaFinancialAddress, #/components/schemas/CryptoWalletFinancialAddress` to the `destination` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the `destination` response property `oneOf` list for the response status `200`
  - the `created_at` response's property pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$` was added for the status `200`
  - the `updated_at` response's property pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$` was added for the status `200`
- **2026-08-17** `3ed0a0aba68b`: 4 breaking, 4 info
  - removed the enum value `BTC` of the request property `currency`
  - removed the enum value `ETH` of the request property `currency`
  - removed the enum value `POL` of the request property `currency`
  - removed the enum value `SOL` of the request property `currency`
  - removed the `BTC` enum value from the `currency` response property for the response status `200`
  - removed the `ETH` enum value from the `currency` response property for the response status `200`
  - removed the `POL` enum value from the `currency` response property for the response status `200`
  - removed the `SOL` enum value from the `currency` response property for the response status `200`
- **2026-07-27** `1d6de495a31d`: 1 breaking
  - the `header` request parameter `Idempotency-Key` became required
- **2026-07-13** `d92a4abea6c4`: 3 warning, 3 info
  - added the new `ETH` enum value to the `currency` response property for the response status `200`
  - added the new `POL` enum value to the `currency` response property for the response status `200`
  - added the new `SOL` enum value to the `currency` response property for the response status `200`
  - added the new `ETH` enum value to the request property `currency`
  - added the new `POL` enum value to the request property `currency`
  - added the new `SOL` enum value to the request property `currency`
- **2026-06-17** `74deb4d45f9f`: 1 breaking, 6 warning, 2 info
  - removed `subschema #3` from the `destination` request property `oneOf` list
  - added the new `BTC` enum value to the `currency` response property for the response status `200`
  - added the new `bitcoin` enum value to the `destination/oneOf[subschema #4]/blockchain` response property for the response status `200`
  - added the new `bitcoin_testnet4` enum value to the `destination/oneOf[subschema #4]/blockchain` response property for the response status `200`
  - added the new `ethereum_sepolia` enum value to the `destination/oneOf[subschema #4]/blockchain` response property for the response status `200`
  - added the new `polygon_amoy` enum value to the `destination/oneOf[subschema #4]/blockchain` response property for the response status `200`
  - added the new `solana_devnet` enum value to the `destination/oneOf[subschema #4]/blockchain` response property for the response status `200`
  - added the new `BTC` enum value to the request property `currency`
  - added `subschema #3, subschema #4` to the `destination` request property `oneOf` list
- **2026-04-29** `87ee55c3e7c4`: 1 breaking
  - added `subschema #3` to the `destination` response property `oneOf` list for the response status `200`
- **2026-04-24** `75f9878ced37`: 4 warning, 1 info
  - added the new `EUR` enum value to the `currency` response property for the response status `200`
  - added the new `GBP` enum value to the `currency` response property for the response status `200`
  - added the new `USD` enum value to the `currency` response property for the response status `200`
  - added the new `USDC` enum value to the `currency` response property for the response status `200`
  - added the new `USD` enum value to the request property `currency`
- **2026-04-22** `7e26180bf667`: 2 breaking, 2 info
  - removed `subschema #1, subschema #2, subschema #3` from the `destination` request property `oneOf` list
  - added `subschema #1, subschema #2, subschema #3` to the `destination` response property `oneOf` list for the response status `200`
  - added `subschema #1, subschema #2, subschema #3` to the `destination` request property `oneOf` list
  - removed `subschema #1, subschema #2, subschema #3` from the `destination` response property `oneOf` list for the response status `200`
- **2026-03-26** `46f498194a49`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/augustus/apis/ivy-api/docs/v1/payouts/post.md) - [API](https://skmtc.dev/augustus/apis/ivy-api.md) - [Page](https://skmtc.dev/augustus/apis/ivy-api/changes/v1/payouts/post)