---
title: "Create Withdrawal Request"
method: POST
path: "/v0/withdrawal-requests"
tags: ["Withdrawal Requests"]
---

# Create Withdrawal Request

`POST /v0/withdrawal-requests`

Start creating Bitcoin voucher QR codes.

## Headers

- `Content-Type` string

## Request body

- object
  - `amount` string — The amount for the Withdrawal Request -> in millisatoshis
  - `description` string — Note or comment for this Withdrawal Request
  - `expiresIn` number — Time until Withdrawal Request expiration -> in seconds
  - `internalId` string — Open metadata string property
  - `callbackUrl` string — The endpoint ZBD will POST Charge updates to

## Response `200`

Successful response

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

## Changes

- **2025-04-18** `b749c336df59` — 1 warning, 1 info
  - deleted the `header` request parameter `apikey`
  - the endpoint scheme security `apikeyAuth` was added to the API
- **2025-04-18** `028610bc46ff` — 1 breaking
  - the `header` request parameter `apikey` became required

[Change history](https://skmtc.dev/zbdpay/apis/zbd-payments-api/changes/v0/withdrawal-requests/post.md)

---

[API](https://skmtc.dev/zbdpay/apis/zbd-payments-api.md) · [All operations](https://skmtc.dev/zbdpay/apis/zbd-payments-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zbdpay/zbd-payments-api/revisions/0d5fdd96023d/schema)