---
title: "Create a workspace"
description: "A new workspace owned by the person, on the Free plan, which the app opens for them from then on."
url: "https://openemail.uk/docs/api/workspaces/create"
area: "API"
category: "Your account"
---

# Create a workspace

A new workspace owned by the person, on the Free plan, which the app opens for them from then on.

`POST /workspaces`

## POST /workspaces

A new workspace owned by the person, on the Free plan, which the app opens for them from then on.

## Example

Needs `account:write`. `name` is up to 64 characters. Answers 201 with the new workspace.

**curl**

```
curl -X POST "$OE/workspaces" -H "$AUTH" -H "Content-Type: application/json" \
  -d '{ "name": "Acme Support" }'
```

**Response**

```
{
  "object": "workspace",
  "id": "6d2f8a41-9c3e-4b7a-8e15-2f0c9d4b7a63",
  "name": "Acme Support",
  "slug": "acme-support",
  "active": true
}
```

> An account can own one workspace on the Free plan, so while it owns one the call is a 403 `workspace_allowance_reached` that names it. Upgrade that workspace first.

> The same name sent twice within ten seconds returns the workspace the first call made, so a double submit makes one workspace.

## Reference

- [`POST /workspaces`](https://openemail.uk/docs/api/reference/workspaces#post-workspaces): full reference