---
title: "PUT /groups/{groupID}/memberships"
method: PUT
path: "/groups/{groupID}/memberships"
tags: ["groups"]
---

# PUT /groups/{groupID}/memberships

`PUT /groups/{groupID}/memberships`

Add users to a group

## Path parameters

- `groupID` string, uuid, required

## Request body

- object
  - `emails` string[], required — The emails of the users that should be added to the group
  - `shouldRemoveFromSiblingGroups` boolean — If true, the users will be removed from any other groups that share a parent group with the selected group. Useful when moving users between different stages

## Response `200`

Successful response

## Other responses

- `401` — API Key is missing or invalid
- `404` — Could not find requested group id or user email

---

[API](https://skmtc.dev/heartbeat/apis/heartbeat-api.md) · [All operations](https://skmtc.dev/heartbeat/apis/heartbeat-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/heartbeat/heartbeat-api/revisions/6c3cf537d508/schema)