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

# Changes to Create payout

`POST /v2/payouts`

> Every recorded change to this endpoint, newest first.
> 79 revisions in range; 9 not diffed.

## Timeline

Changed in 7 of 79 revisions.

- **2026-08-05** `40ce187fe729` — 1 breaking, 1 info
- **2026-06-22** `1fdc21356fc6` — 1 info
- **2026-05-19** `7cab62b21830` — 1 info
- **2026-05-19** `1fe398fe9915` — 1 warning
- **2026-05-13** `c9097984fd6b` — 5 breaking, 1 warning, 4 info
- **2026-05-12** `24fb0b873cfe` — 1 breaking
- **2026-05-12** `f5e0eb3b7313` — 1 info

## Changes

- **2026-08-05** `40ce187fe729` — 1 breaking, 1 info
  - the response property `description` became nullable for the status `201`
  - the request property `allOf[#/components/schemas/entity-payout]/description` became nullable
- **2026-06-22** `1fdc21356fc6` — 1 info
  - the endpoint scheme security `oAuth` was removed from the API
- **2026-05-19** `7cab62b21830` — 1 info
  - added the non-success response with the status `429`
- **2026-05-19** `1fe398fe9915` — 1 warning
  - deleted the `query` request parameter `testmode`
- **2026-05-13** `c9097984fd6b` — 5 breaking, 1 warning, 4 info
  - added the new required request property `allOf[#/components/schemas/entity-payout]/amount/currency`
  - added the new required request property `allOf[#/components/schemas/entity-payout]/amount/value`
  - the `allOf[#/components/schemas/entity-payout]/amount` request property type changed from no type to `object, null`
  - the response property `amount` became nullable for the status `201`
  - the `amount` response's property type changed from no type to `object, null` for status `201`
  - removed `#/components/schemas/amount-nullable` from the `allOf[#/components/schemas/entity-payout]/amount` request property `allOf` list
  - the request property `allOf[#/components/schemas/entity-payout]/amount` became nullable
  - removed `#/components/schemas/amount-nullable` from the `amount` response property `allOf` list for the response status `201`
  - added the required property `amount/currency` to the response with the `201` status
  - added the required property `amount/value` to the response with the `201` status
- **2026-05-12** `24fb0b873cfe` — 1 breaking
  - the request property `allOf[#/components/schemas/entity-payout]/balanceId` became not nullable
- **2026-05-12** `f5e0eb3b7313` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/mollie/apis/mollie-api/docs/v2/payouts/post.md) · [API](https://skmtc.dev/mollie/apis/mollie-api.md) · [Page](https://skmtc.dev/mollie/apis/mollie-api/changes/v2/payouts/post)