---
title: "Create Group"
method: POST
path: "/groups"
tags: ["Groups"]
---

# Create Group

`POST /groups`

## Request

- Base URL: `https://apibeta.familysearch.org/platform`
- URL: `https://apibeta.familysearch.org/platform/groups`
- Auth: HTTP bearer

Create a user tree group. A user tree group is represented as a GedcomX FamilySearch extension [`Group`](#schema-Group).

## Headers

- `Content-Type` 'application/x-fs-v1+json', required

## Request body

- CreateGroup
  - `groups` object[], required: Array containing the user tree group to create. See <a href="https://developers.familysearch.org/main/docs/json-schema#group" target="_blank">Group Schema (JSON)</a>
    - `name` string, required: The name of the user tree group
    - `description` string: A description of the user tree group (optional)
    - `codeOfConduct` string: The code of conduct for the user tree group (optional)

## Response `201`

The creation of the user tree group was successful. Expect an X-Entity-Id header specifying the ID of the new group and a Location header containing the URL for the new group.

## Other responses

- `429`: The request was throttled.

---

[API](https://skmtc.dev/familysearch/apis/user-tree-endpoints.md) - [All operations](https://skmtc.dev/familysearch/apis/user-tree-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/familysearch/apis/user-tree-endpoints/revisions/8ae07006966b?raw)