---
title: "POST /v2/domains/{domainIdentifier}/domain-units"
method: POST
path: "/v2/domains/{domainIdentifier}/domain-units"
---

# POST /v2/domains/{domainIdentifier}/domain-units

`POST /v2/domains/{domainIdentifier}/domain-units`

Creates a domain unit in Amazon DataZone.

## Path parameters

- `domainIdentifier` string, required

## Request body

- object
  - `name` string, password, required — The name of the domain unit.
  - `parentDomainUnitIdentifier` string, required — The ID of the parent domain unit.
  - `description` string, password — The description of the domain unit.
  - `clientToken` string — A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

## Response `201`

Success

- CreateDomainUnitOutput
  - `id` string, required — The ID of the domain unit.
  - `domainId` string, required — The ID of the domain where the domain unit was created.
  - `name` string, password, required — The name of the domain unit.
  - `parentDomainUnitId` string — The ID of the parent domain unit.
  - `description` string, password — The description of the domain unit.
  - `owners` DomainUnitOwnerProperties[], required — The owners of the domain unit.
    - `user` object — Indicates that the domain unit owner is a user.
      - `userId` string — The ID of teh domain unit user.
    - `group` object — Indicates that the domain unit owner is a group.
      - `groupId` string — The ID of the domain unit group.
  - `ancestorDomainUnitIds` DomainUnitId[], required — The IDs of the ancestor domain units.
  - `createdAt` string, date-time — The timestamp at which the domain unit was created.
  - `createdBy` string — The user who created the domain unit.

## Other responses

- `480` — InternalServerException
- `481` — AccessDeniedException
- `482` — ThrottlingException
- `483` — ServiceQuotaExceededException
- `484` — ConflictException
- `485` — ValidationException
- `486` — UnauthorizedException

---

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