---
title: "Create a Workspace"
method: POST
path: "/v2/workspace"
tags: ["Workspace"]
---

# Create a Workspace

`POST /v2/workspace`

## Request

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

Here you can create a brand new Workspace.
Note: Only Organization credentials are able to create Workspaces.

## Request body

- object
  - `name` string, required: This string will show up to identify your Workspace when you log into it at our Web Banking. Example: 'My Workspace'
  - `username` string, required: This string uniquely identifies the Workspace in our entire database. It is also part of the Workspace Web Banking URL and must, therefore, be URL-safe. For example, if a Workspace in Sandbox has the 'my-workspace' username, its URL would be "https://my-workspace.sandbox.starkbank.com"
  - `allowedTaxIds` string[]: List of tax IDs that will be allowed to send Deposits to this Workspace. If empty, all are allowed. Example: ["012.345.678-90", "20.018.183/0001-80"]

## 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)