---
title: "Add Members to the Team"
slug: "add-members-to-the-team"
updated: 2026-06-01T06:32:04Z
published: 2026-06-01T06:32:04Z
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.

# Add Members to the Team

Post/api/v1/teams.addMembers

Add members to a team.

Permissions required: `add-team-member` or `edit-team-member`

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='85309312-57f3-4431-912e-fffb7e8d1c1b'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='7e5a0e28-15c4-418c-8a1e-579f4e907a09'>Example</option>
</select>Example

```json
{
  "teamId": "63f3efc4b000b6b6d86704b2",
  "members": [
    {
      "userId": "rYhzFRd2QZjNwAAXX",
      "roles": [
        "member"
      ]
    }
  ]
}
```

Expand Allobject  teamIdstring    Required

Enter the team ID. Alternatively, enter the `teamName` parameter and provide the team's name as the value.

members Array of object   Required

The users (IDs and roles) to add to the team.

object  userIdstring    
roles Array of string   string    

Responses200

OK

<select class='api-response-data' aria-label='Media type'><option value='4f03a04e-0e80-4b26-a61a-881557f7ae9d'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='ea953fdd-f9d7-4424-a8ef-eff7c49d2ab2'>Success</option>
</select>Success

```json
{
  "success": true
}
```

object  successboolean    

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='d292513d-1a56-415b-b826-b7270720e8be'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='0d3c6499-a26c-4ccb-a545-cb6d3773bcd5'>Authorization Error</option>
</select>Authorization Error

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

object  statusstring    
messagestring