---
title: "Create Card Hierarchy Group"
method: POST
path: "/v1/card-hierarchies/{cardHierarchyId}/groups"
tags: ["Card Hierarchy Group Management"]
---

# Create Card Hierarchy Group

`POST /v1/card-hierarchies/{cardHierarchyId}/groups`

This operation creates a new group within a specified card hierarchy. The new group must have a parent group ID and can be either `INTERMEDIATE` or `CARD` type.

## Path parameters

- `cardHierarchyId` string, biginteger, required

## Query parameters

- `auditUser` string, required

## Request body

- CreateCardHierarchyGroupV1Request
  - `name` string, required — Name of the group
  - `parentId` string, biginteger, required — Id of the parent group
  - `type` 'ROOT' | 'INTERMEDIATE' | 'CARD', required — Type of the group

## Response `201`

Card Hierarchy group successfully created

- CardHierarchyGroupV1
  - `id` string, biginteger, required — Generated id of the group
  - `name` string, required — Name of the group
  - `parentId` string, biginteger — Id of the parent group
  - `type` 'ROOT' | 'INTERMEDIATE' | 'CARD', required — Type of the group

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.net/enfuce/apis/transfer-api.md) · [All operations](https://skmtc.net/enfuce/apis/transfer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/enfuce/transfer-api/revisions/dc4a41118f80/schema)