---
title: "Add group member"
method: PUT
path: "/groups/{groupId}/members/{userId}"
tags: ["Groups"]
---

# Add group member

`PUT /groups/{groupId}/members/{userId}`

## Request

- Base URL: `https://demodesk.com/api/v2`
- URL: `https://demodesk.com/api/v2/groups/{groupId}/members/{userId}`
- Auth: HTTP bearer

Adds a user to a restricted group of the company. The request has no body.

The operation is idempotent. It returns `201` when the membership was created and `200` with the same
body when the user already was a member.

Shared groups contain every user of the company, so their membership cannot be changed and the
request returns `400` with the code `group_not_restricted`.

Changing the membership has the same effects as in Settings > Groups, including updating the group
visibility of the user's scheduled meetings.

Changing a group requires the permission to edit it in the web app: a company admin, or a manager who
is a member of the group. A group that is readable but not editable returns `403`. A group that is
unknown, personal, or not readable returns `404` with the code `group_not_found`. A user that is
unknown, blocked, or in another company returns `404` with the code `user_not_found`.

Rate limits:
- Global: 120 requests per minute per API key.

## Path parameters

- `groupId` string, required
- `userId` string, required

## Response `200`

The user already was a member of the group.

- GroupMemberResponse
  - `data` GroupMemberItem, required
    - `groupId` string, required: Internal group id.
    - `userId` string, required: Internal user id.
    - `createdAt` string, date-time, required: When the user was added to the group.

## Other responses

- `201`: The user was added to the group.
- `400`: Request validation failed.
- `401`: API key is missing or invalid.
- `403`: The authenticated user is not allowed to access this resource, e.g. it is not assigned to a company.
- `404`: Resource was not found.
- `429`: Rate limit exceeded.

## Changes

- **2026-10-18** `14d6c8e2e11a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/demodesk/apis/demodesk-public-api/changes/groups/:groupId/members/:userId/put.md)

---

[API](https://skmtc.dev/demodesk/apis/demodesk-public-api.md) - [All operations](https://skmtc.dev/demodesk/apis/demodesk-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/demodesk/apis/demodesk-public-api/revisions/8729e4025dc9?raw)