---
title: "PUT /groups"
method: PUT
path: "/groups"
tags: ["groups"]
---

# PUT /groups

`PUT /groups`

Create a new Group in a Heartbeat community

## Request body

- object
  - `name` string, required
  - `description` string
  - `members` string[] — The email addresses of the users that should be added to the group
  - `parentGroupID` string, uuid — The id of the parent group
  - `isIsolated` boolean — Whether the group is isolated. Refer to Heartbeat docs to learn more about what this entails
  - `isJoinable` boolean — Whether the group is joinable. Refer to Heartbeat docs to learn more about what this entails

## Response `200`

Successful response

## Other responses

- `400` — Invalid request body
- `401` — API Key is missing or invalid

---

[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)