---
title: "Create Tenant"
method: POST
path: "/api/v1/tenants"
tags: ["tenants"]
---

# Create Tenant

`POST /api/v1/tenants`

## Request

- Base URL: `https://api.aws.cognee.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.aws.cognee.ai/api/v1/tenants`
- Auth: API key in header `X-Api-Key`

Create a new tenant.

This endpoint creates a new tenant with the specified name. Tenants are used
to organize users and resources in multi-tenant environments, providing
isolation and access control between different groups or organizations.

## Request Parameters
- **tenant_name** (str): The name of the tenant to create

## Response
Returns a success message indicating the tenant was created.

## Error Codes
- **400 Bad Request**: Invalid tenant name or tenant already exists
- **500 Internal Server Error**: Error creating the tenant

## Query parameters

- `tenant_name` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/cognee/apis/cognee-api.md) - [All operations](https://skmtc.dev/cognee/apis/cognee-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cognee/apis/cognee-api/revisions/a7b6c6cb8212?raw)