---
title: "Create a New Team"
slug: "create-a-new-team"
updated: 2026-06-08T12:46:40Z
published: 2026-06-08T12:46:40Z
stale: true
---

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

# Create a New Team

Post/api/v1/teams.create

Create a new public or private team in the workspace.

Permission required: `create-team`

Header parametersX-Auth-TokenstringRequired

The `authToken` of the authenticated user.

ExampleRScctEHSmLGZGywfIhWyRpyofhKOiMoUIpimhvheU3f
X-User-IdstringRequired

The `userId` of the authenticated user.

ExamplerbAXPnMktTFbNpwtJ

Body parameters<select class='api-response-data' aria-label='Media type'><option value='a0a2d085-31ff-42ff-9042-1f76a2804b31'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='0f9429bb-3115-48cd-af44-2d4245845148'>Example</option>
</select>Example

```json
{
  "name": "teamName",
  "type": 0,
  "members": [
    "8dugqGhuRvCBLdZft"
  ],
  "room": {
    "readOnly": true
  },
  "sidepanel": {
    "items": [
      "discussions",
      "channels"
    ]
  }
}
```

Expand Allobject  namestring    Required

The team name.

typeinteger    Required

Privacy of the team (0 - Public, 1 - Private).

members Array of string   

The user IDs to add to the team when it is created.

string    
roomobject  readOnlyboolean    

sidepanelobject  

List the team's channels or discussions to be displayed in the sidepanel.

items Array of string   

The options are `discussions` and `channels`.

string    Example["discussions", "channels"]

ownerstring    

Set the owner of the team.

Responses200

OK

Note that the `roomId` is main room ID of the team.

<select class='api-response-data' aria-label='Media type'><option value='c5f7b8a6-2ea6-4a11-8d9e-231bfb10daae'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='86334b72-e072-483f-b1d5-b4c7f529449a'>Success</option>
</select>Success

```json
{
  "team": {
    "_id": "651619e3a2f73c7460e18cc5",
    "name": "teamName",
    "type": 0,
    "createdAt": "2023-09-29T00:27:15.189Z",
    "createdBy": {
      "_id": "rbAXPnMktTFbNpwtJ",
      "username": "roxie"
    },
    "_updatedAt": "2023-09-29T00:27:15.189Z",
    "roomId": "651619e3a2f73c7460e18cc7"
  },
  "success": true
}
```

Expand Allobject  teamobject  _idstring    
namestring    
typeinteger    
createdAtstring    
createdByobject  _idstring    
usernamestring    

_updatedAtstring    
roomIdstring    

successboolean    

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='80a148dc-d93b-489e-b7bc-4b8da62b73c0'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='962b21fe-9013-48ba-bbc4-0db8ae341496'>Authorization Error</option>
</select>Authorization Error

```json
{
  "status": "error",
  "message": "You must be logged in to do this."
}
```

object  statusstring    
messagestring