# Create workspace

`POST https://api.airtable.com/v0/meta/workspaces`

Creates a new workspace with the provided name within the specified enterprise account and returns the workspace id.
The requesting user must be an active effective admin of the enterprise account; the created workspace's owner will be the user who makes the request.

## Requirements

- **Authentication:** [Personal access token](https://airtable.com/developers/web/api/authentication.md#types-of-token), [OAuth integration](https://airtable.com/developers/web/api/authentication.md#types-of-token)
- **Scope:** [`workspacesAndBases:manage`](https://airtable.com/developers/web/api/scopes.md#workspaces-and-bases-manage)
- **User role:** Enterprise admin
- **Billing plans:** Enterprise (pre-2023.08 legacy plan), Enterprise Scale

## Request body

- `enterpriseAccountId: string` — required

  The enterprise account that the workspace will be created in.

- `name: string` — required

  Name of the workspace to be created.

## Response format

- `id: string` — required

### Example — Success response

```sh
curl -X POST "https://api.airtable.com/v0/meta/workspaces" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
--data '{
    "enterpriseAccountId": "entUBq2RGdihxl3vU",
    "name": "My New Workspace"
  }'
```

```json
{
  "id": "wspmhESAta6clCCwF"
}
```