---
title: "Create a Corporate Withdrawal"
method: POST
path: "/v2/corporate-withdrawal"
tags: ["Corporate Withdrawal"]
---

# Create a Corporate Withdrawal

`POST /v2/corporate-withdrawal`

## Request

- Base URL: `https://api.starkbank.com`
- URL: `https://api.starkbank.com/v2/corporate-withdrawal`
- Auth: API key in header `Digital-Signature`

Use this route to create a new Corporate Withdrawal and return cash from your Corporate balance to your Banking balance.
NOTE:The Corporate Transaction that debits your Corporate balance is created within the same request, so corporateTransactionId comes back filled. The cash is credited to your Banking balance right after, so transactionId comes back empty and is filled in a few moments later.
NOTE:The request is refused when your Corporate balance does not cover the amount.

## Request body

- object
  - `amount` integer, required: A positive integer that represents the amount in cents to be returned to your Banking balance. Example: 10000 (R$100.00)
  - `externalId` string, required: Unique id chosen by you to identify the Corporate Withdrawal. An externalId already used in your Workspace is rejected instead of creating a second Corporate Withdrawal. Example: "my-external-id"
  - `tags` string[]: Array of up to 100 strings to tag the entity for future queries. Each tag can have up to 100 characters and all tags will be converted to lowercase. Example: ["tony", "stark"]

## Response `200`

Successful operation

- object

## Other responses

- `400`: Client error
- `500`: Server error

---

[API](https://skmtc.dev/starkbank/apis/stark-bank-api.md) - [All operations](https://skmtc.dev/starkbank/apis/stark-bank-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starkbank/apis/stark-bank-api/revisions/aeff5068a5da?raw)