---
title: "Changes to Create a withdrawal"
method: POST
path: "/v1/withdrawals"
---

# Changes to Create a withdrawal

`POST /v1/withdrawals`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 13 revisions.

- **2026-08-27** `9d4ba1cc037c` — 1 breaking, 3 warning, 4 info
- **2026-08-27** `8ba4c7f9e9db` — 4 warning, 2 info
- **2026-05-04** `fdc857fbd70e` — 1 warning
- **2026-04-14** `74ad5da44cf9` — 8 breaking, 1 warning, 6 info
- **2026-04-14** `c75657100757` — 1 info

## Changes

- **2026-08-27** `9d4ba1cc037c` — 1 breaking, 3 warning, 4 info
  - the `error` response's property type/format changed from `object`/`` to `string`/`` for status `409`
  - removed the optional property `error/code` from the response with the `409` status
  - removed the optional property `error/details` from the response with the `409` status
  - removed the optional property `error/message` from the response with the `409` status
  - added the non-success response with the status `500`
  - added the optional property `code` to the response with the `409` status
  - added the optional property `message` to the response with the `409` status
  - added the optional property `statusCode` to the response with the `409` status
- **2026-08-27** `8ba4c7f9e9db` — 4 warning, 2 info
  - removed the optional property `withdrawal/errorMessage` from the response with the `201` status
  - removed the optional property `withdrawal/pixKey` from the response with the `201` status
  - removed the optional property `withdrawal/pixKeyType` from the response with the `201` status
  - removed the optional property `withdrawal/processedAt` from the response with the `201` status
  - added the new optional request property `destination/recipientDocument`
  - added the non-success response with the status `503`
- **2026-05-04** `fdc857fbd70e` — 1 warning
  - removed the request property `destination/recipientDocument`
- **2026-04-14** `74ad5da44cf9` — 8 breaking, 1 warning, 6 info
  - added the new required request property `destination/pixKey`
  - added the new required request property `destination/type`
  - removed the enum value `BOLETO` of the request property `method`
  - removed the enum value `CARD` of the request property `method`
  - removed the enum value `CRYPTO_LTC` of the request property `method`
  - removed the enum value `LTC` of the request property `currency`
  - removed `subschema #1: PIX destination, subschema #2: Crypto destination` from the `destination` request property `oneOf` list
  - the `destination` request property type/format changed from ``/`` to `object`/``
  - removed the request property `idempotencyKey`
  - added the new optional request property `destination/recipientDocument`
  - removed discriminator from `destination` request property
  - added the optional property `withdrawal/currency` to the response with the `201` status
  - added the optional property `withdrawal/errorMessage` to the response with the `201` status
  - added the optional property `withdrawal/paymentMethod` to the response with the `201` status
  - added the optional property `withdrawal/processedAt` to the response with the `201` status
- **2026-04-14** `c75657100757` — 1 info
  - endpoint added

---

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