> ## Documentation Index
> Fetch the complete documentation index at: https://docs.emailbison.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating Workspaces

<Note>
  **This workflow requires a `super-admin` key.**

  For a refresher on the difference between the key types, you can visit [Authentication](/get-started/authentication).
</Note>

Workspaces can be created using the API.

### Creating a Workspace

Send a `POST` request to `/api/workspaces/v1.1`.

You must include a `name` field in a JSON body, this field is the name of the workspace you are creating.

An example of a request to create a new workspace with the name **new name**:

<CodeGroup>
  ```bash curl theme={null}
  curl https://dedi.emailbison.com/api/workspaces/v1.1 \
    --request POST \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
    --data '{
    "name": "New name"
  }'
  ```

  ```JavaScript JavaScript theme={null}
  fetch('https://dedi.emailbison.com/api/workspaces/v1.1', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      Authorization: 'Bearer YOUR_SECRET_TOKEN'
    },
    body: JSON.stringify({
      name: 'New name'
    })
  })
  ```

  ```Python Python theme={null}
  import requests

  url = "https://dedi.emailbison.com/api/workspaces/v1.1"

  payload = { "name": "New name" }
  headers = {
      "Content-Type": "application/json",
      "Authorization": "Bearer YOUR_SECRET_TOKEN"
  }

  response = requests.post(url, json=payload, headers=headers)
  ```
</CodeGroup>
