v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-14171791756.1 KB

Creates a new user hierarchy group.

put/user-hierarchy-groups/{InstanceId}

Path parameters

InstanceIdstring required

The identifier of the Amazon Connect instance. You can <a href="https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html">find the instance ID</a> in the Amazon Resource Name (ARN) of the instance.

Request body

Namestring required

The name of the user hierarchy group. Must not be more than 100 characters.

ParentGroupIdstring

The identifier for the parent hierarchy group. The user hierarchy is created at level one if the parent group ID is null.

Tagsobject

The tags used to organize, track, or control access for this resource. For example, { "tags": {"key1":"value1", "key2":"value2"} }.

Response

Success

HierarchyGroupIdstring

The identifier of the hierarchy group.

HierarchyGroupArnstring

The Amazon Resource Name (ARN) of the hierarchy group.