---
title: "Create a workspace"
method: POST
path: "/workspace/create/"
tags: ["Workspaces"]
---

# Create a workspace

`POST /workspace/create/`

## Request

- Base URL: `https://hovercode.com/api/v2`
- URL: `https://hovercode.com/api/v2/workspace/create/`
- Auth: API key in header `Authorization`

Creates a workspace owned by you, e.g. one per customer when building QR codes into your product. Doesn't change your current workspace. 403 when your plan's workspace limit is reached.

## Request body

- object
  - `name` string, required

## Response `201`

Created

- Workspace
  - `id` string, uuid
  - `name` string
  - `current` boolean
  - `plan` string
  - `paid` boolean
  - `dynamic_qr_used` integer, nullable
  - `dynamic_qr_limit` integer, nullable
  - `pages_used` integer, nullable

## Other responses

- `400`: Invalid name
- `401`: Missing or invalid API token.
- `403`: Workspace limit reached for your plan

---

[API](https://skmtc.dev/hovercode/apis/hovercode-api.md) · [All operations](https://skmtc.dev/hovercode/apis/hovercode-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hovercode/apis/hovercode-api/revisions/4a9bc3cafe41?raw)