---
title: "Create Card Hierarchy (Root Group)"
method: POST
path: "/v1/card-hierarchies"
tags: ["Card Hierarchy Management"]
---

# Create Card Hierarchy (Root Group)

`POST /v1/card-hierarchies`

This operation creates a new card hierarchy, generating a root group with the specified name and ID. Only one card hierarchy can be active at a time.

## Query parameters

- `auditUser` string, required

## Request body

- CreateCardHierarchyV1Request
  - `name` string, required — Name of the card hierarchy
  - `active` boolean, required — Whether the card hierarchy is active or not

## Response `201`

Card hierarchy successfully created

- CardHierarchyV1
  - `id` string, biginteger, required — Generated id of the card hierarchy
  - `name` string, required — Name of the card hierarchy
  - `active` boolean, required — Whether the card hierarchy is active or not

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