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

# Changes to Create Payout

`POST /payouts`

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

## Timeline

Changed in 17 of 74 revisions.

- **2026-09-02** `9b2baa68698c` — 2 info
- **2026-08-27** `16c82685be35` — 1 info
- **2026-08-25** `621705ee8f4a` — 2 warning, 2 info
- **2026-08-21** `715c4defcbbf` — 5 breaking, 4 warning, 4 info
- **2026-08-20** `4a1a4a5d2c72` — 7 info
- **2026-08-20** `6a23760847c8` — 1 breaking, 1 info
- **2026-08-18** `f67a043e3190` — 4 info
- **2026-08-14** `a84d4905fdbb` — 1 breaking, 1 info
- **2026-08-12** `ae20b30817de` — 2 info
- **2026-08-12** `6fb1c04bf255` — 3 info
- **2026-08-11** `a01100378e59` — 2 info
- **2026-08-08** `db0883548bc5` — 2 info
- **2026-08-07** `f1020c3ecda4` — 6 info
- **2026-08-05** `6c970f803b46` — 1 info
- **2026-08-02** `a40f17e91cbf` — 1 warning
- **2026-07-31** `099fdc3be422` — 1 breaking, 1 info
- **2026-07-26** `60bbb4a6ffbc` — 2 warning, 1 info

## Changes

- **2026-09-02** `9b2baa68698c` — 2 info
  - added the new optional request property `statement_descriptor`
  - added the required property `statement_descriptor` to the response with the `201` status
- **2026-08-27** `16c82685be35` — 1 info
  - added the new optional request property `quote_token`
- **2026-08-25** `621705ee8f4a` — 2 warning, 2 info
  - added the new `card` enum value to the `payout_method/supported_payout_method/delivery_type` response property for the response status `201`
  - added the new `check` enum value to the `payout_method/supported_payout_method/delivery_type` response property for the response status `201`
  - removed the `masspay_card` enum value from the `payout_method/supported_payout_method/delivery_type` response property for the response status `201`
  - removed the `paper_check` enum value from the `payout_method/supported_payout_method/delivery_type` response property for the response status `201`
- **2026-08-21** `715c4defcbbf` — 5 breaking, 4 warning, 4 info
  - the `amount` response's property type changed from `number` to `string`, and format from `float` to `decimal` for status `201`
  - the `destination_amount` response's property type changed from `number, null` to `string, null`, and format from `float` to `decimal` for status `201`
  - the `fee_amount` response's property type changed from `number` to `string`, and format from `float` to `decimal` for status `201`
  - the `markup_fee` response's property type changed from `number` to `string`, and format from `float` to `decimal` for status `201`
  - the `net_amount` response's property type changed from `number` to `string`, and format from `float` to `decimal` for status `201`
  - removed the request property `idempotency_key`
  - added the new `in_review` enum value to the `status` response property for the response status `201`
  - added the new `processing` enum value to the `status` response property for the response status `201`
  - added the new `reversed` enum value to the `status` response property for the response status `201`
  - removed the `awaiting_payment` enum value from the `status` response property for the response status `201`
  - removed the `in_transit` enum value from the `status` response property for the response status `201`
  - added the required property `payout_request_id` to the response with the `201` status
  - added the required property `status_detail` to the response with the `201` status
- **2026-08-20** `4a1a4a5d2c72` — 7 info
  - added the new optional request property `metadata`
  - added the required property `failure` to the response with the `201` status
  - added the required property `fee_paid_by` to the response with the `201` status
  - added the required property `markup_fee` to the response with the `201` status
  - added the required property `metadata` to the response with the `201` status
  - added the required property `net_amount` to the response with the `201` status
  - added the required property `source` to the response with the `201` status
- **2026-08-20** `6a23760847c8` — 1 breaking, 1 info
  - removed `subschema #1, subschema #2` from the request body `oneOf` list
  - added `subschema #1, subschema #2` to the request body `oneOf` list
- **2026-08-18** `f67a043e3190` — 4 info
  - added the required property `destination_amount` to the response with the `201` status
  - added the required property `destination_currency` to the response with the `201` status
  - added the required property `exchange_rate` to the response with the `201` status
  - added the required property `payout_method/supported_payout_method/delivery_type` to the response with the `201` status
- **2026-08-14** `a84d4905fdbb` — 1 breaking, 1 info
  - removed `subschema #1, subschema #2` from the request body `oneOf` list
  - added `subschema #1, subschema #2` to the request body `oneOf` list
- **2026-08-12** `ae20b30817de` — 2 info
  - the `acknowledge_bank_warning` request property default value `false` was removed
  - added the non-success response with the status `409`
- **2026-08-12** `6fb1c04bf255` — 3 info
  - added the new optional request property `acknowledge_bank_warning`
  - added `subschema #1, subschema #2` to the request body `oneOf` list
  - added the required property `trace_code` to the response with the `201` status
- **2026-08-11** `a01100378e59` — 2 info
  - added the new optional request property `notes`
  - added the required property `notes` to the response with the `201` status
- **2026-08-08** `db0883548bc5` — 2 info
  - added the new optional request property `user_id`
  - the request property `account_id` became optional
- **2026-08-07** `f1020c3ecda4` — 6 info
  - added the new optional request property `idempotency_key`
  - added the new optional request property `platform_covers_fees`
  - added the optional property `error/code` to the response with the `400` status
  - added the optional property `error/code` to the response with the `401` status
  - added the optional property `error/code` to the response with the `403` status
  - added the optional property `error/code` to the response with the `404` status
- **2026-08-05** `6c970f803b46` — 1 info
  - added the new optional request property `speed`
- **2026-08-02** `a40f17e91cbf` — 1 warning
  - added the new `awaiting_payment` enum value to the `status` response property for the response status `201`
- **2026-07-31** `099fdc3be422` — 1 breaking, 1 info
  - removed the required property `payout_token` from the response with the `201` status
  - added the required property `payout_method` to the response with the `201` status
- **2026-07-26** `60bbb4a6ffbc` — 2 warning, 1 info
  - removed the request property `idempotency_key`
  - added the new `denied` enum value to the `status` response property for the response status `201`
  - added the new optional `header` request parameter `Idempotency-Key`

---

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