---
title: "PUT /user-hierarchy-groups/{InstanceId}"
method: PUT
path: "/user-hierarchy-groups/{InstanceId}"
---

# PUT /user-hierarchy-groups/{InstanceId}

`PUT /user-hierarchy-groups/{InstanceId}`

Creates a new user hierarchy group.

## Path parameters

- `InstanceId` string, required

## Request body

- object
  - `Name` string, required — The name of the user hierarchy group. Must not be more than 100 characters.
  - `ParentGroupId` string — The identifier for the parent hierarchy group. The user hierarchy is created at level one if the parent group ID is null.
  - `Tags` object — The tags used to organize, track, or control access for this resource. For example, { "tags": {"key1":"value1", "key2":"value2"} }.

## Response `200`

Success

- CreateUserHierarchyGroupResponse
  - `HierarchyGroupId` string — The identifier of the hierarchy group.
  - `HierarchyGroupArn` string — The Amazon Resource Name (ARN) of the hierarchy group.

## Other responses

- `480` — InvalidRequestException
- `481` — InvalidParameterException
- `482` — DuplicateResourceException
- `483` — LimitExceededException
- `484` — ResourceNotFoundException
- `485` — ThrottlingException
- `486` — InternalServiceException

---

[API](https://skmtc.net/aws/apis/connect.md) · [All operations](https://skmtc.net/aws/apis/connect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/connect/versions/fbcf0a4faed2/schema)