---
title: "Create a Tenant"
method: POST
path: "/tenant_clusters/config/tenants"
tags: ["tenants"]
---

# Create a Tenant

`POST /tenant_clusters/config/tenants`

This operation submits a request to create a Tenant based on the input parameters.

## Request body

- Tenant — Tenant definition.
  - `uuid` string, required — UUID of the tenant.
  - `name` string — name of the tenant.
  - `idp_tenant_identifier` string — IDP Tenant Identifier.

## Response `200`

Success

- TenantStatus — The status of a REST API call. Only used when there is a failure to report.
  - `kind` string — The kind name
  - `code` integer — The HTTP error code.
  - `message_list` MessageResource[]
    - `message` string, required — If state is ERROR, a message describing the error.
    - `reason` string, required — If state is ERROR, a machine-readable snake-cased string.
    - `details` object — Custom key-value details relevant to the status.
  - `state` string
  - `api_version` string

## Other responses

- `201` — Created
- `default` — Internal Error

---

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