---
title: "POST /v4/{+parent}/tenants"
method: POST
path: "/v4/{+parent}/tenants"
tags: ["projects"]
---

# POST /v4/{+parent}/tenants

`POST /v4/{+parent}/tenants`

Creates a new tenant entity.

## Path parameters

- `parent` string, required

## Request body

- Tenant — A Tenant resource represents a tenant in the service. A tenant is a group or entity that shares common access with specific privileges for resources like jobs. Customer may create multiple tenants to provide data isolation for different groups.
  - `name` string — Required during tenant update. The resource name for a tenant. This is generated by the service when a tenant is created. The format is "projects/{project_id}/tenants/{tenant_id}", for example, "projects/foo/tenants/bar".
  - `externalId` string — Required. Client side tenant identifier, used to uniquely identify the tenant. The maximum number of allowed characters is 255.

## Response `200`

Successful response

---

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