# Create beneficiary withdrawal

**POST /api/v1/beneficiaries/withdrawals**

Creates a withdrawal using the saved details from the beneficiary identified in the body. Call GET /api/v1/payment-reasons, then submit its id and required text fields together in the flat paymentReasons object.


## Servers
- https://api.staging.lumetrade.com: https://api.staging.lumetrade.com ()



## Parameters
### Headers

- **X-API-KEY** (string)
  Public API key issued from the Lumetrade API key management flow.

- **X-API-SECRET** (string)
  API secret paired with the public API key.




### Body: application/json (object)

- **beneficiaryId** (string)
  Beneficiary id returned by the beneficiary endpoints.

- **amount** (number)
  Withdrawal amount in the beneficiary currency.

- **paymentReasons** (object)
  Flat payment reason object. Include paymentReasonId and values keyed by requiredTextFields from GET /api/v1/payment-reasons.



## Responses
### 201
Withdrawal created successfully

#### Body: application/json (object)
- **transactionId** (string)
  Created withdrawal transaction id.

- **status** (string)
  Created withdrawal status.


### 400
Request validation failed

#### Body: application/json (object)
- **code** (integer(int32))

- **message** (string)

- **httpStatus** (integer(int32))

- **requestId** (string)

- **timestamp** (string(date-time))

- **errors** (array[object])


### 404
Resource was not found for the authenticated API key owner

#### Body: application/json (object)
- **code** (integer(int32))

- **message** (string)

- **httpStatus** (integer(int32))

- **requestId** (string)

- **timestamp** (string(date-time))

- **errors** (array[object])


### 403
Authenticated API key is not allowed to perform this action

#### Body: application/json (object)
- **code** (integer(int32))

- **message** (string)

- **httpStatus** (integer(int32))

- **requestId** (string)

- **timestamp** (string(date-time))

- **errors** (array[object])


### 429
Cloudflare API rate limit exceeded

#### Body: application/json (object)
- **error** (string)

- **message** (string)


### 401
API key authentication failed

#### Body: application/json (object)
- **code** (integer(int32))

- **message** (string)

- **httpStatus** (integer(int32))

- **requestId** (string)

- **timestamp** (string(date-time))

- **errors** (array[object])


### 500
Unexpected server error

#### Body: application/json (object)
- **code** (integer(int32))

- **message** (string)

- **httpStatus** (integer(int32))

- **requestId** (string)

- **timestamp** (string(date-time))

- **errors** (array[object])



[Powered by Bump.sh](https://bump.sh)