---
title: "POST /v1/{+parent}/tenancyUnits"
method: POST
path: "/v1/{+parent}/tenancyUnits"
tags: ["services"]
---

# POST /v1/{+parent}/tenancyUnits

`POST /v1/{+parent}/tenancyUnits`

Creates a tenancy unit with no tenant resources. If tenancy unit already exists, it will be returned, however, in this case, returned TenancyUnit does not have tenant_resources field set and ListTenancyUnits has to be used to get a complete TenancyUnit with all fields populated.

## Path parameters

- `parent` string, required

## Request body

- CreateTenancyUnitRequest — Request to create a tenancy unit for a service consumer of a managed service.
  - `tenancyUnitId` string — Optional. Optional service producer-provided identifier of the tenancy unit. Must be no longer than 40 characters and preferably URI friendly. If it isn't provided, a UID for the tenancy unit is automatically generated. The identifier must be unique across a managed service. If the tenancy unit already exists for the managed service and service consumer pair, calling `CreateTenancyUnit` returns the existing tenancy unit if the provided identifier is identical or empty, otherwise the call fails.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/serviceconsumermanagement.md) · [All operations](https://skmtc.dev/google/apis/serviceconsumermanagement/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/serviceconsumermanagement/revisions/4ccbdb61fd14/schema)