---
title: "Create Tenants"
description: "This document outlines how to create a new tenant within an existing organization via the walt.id Enterprise API. If you don't yet have an organization, please go here to learn more."
stack: "Enterprise Stack (commercial) — version 0.21.0"
stack_version: "0.21.0"
stack_comparison: https://docs.walt.id/community-vs-enterprise.md
canonical_url: https://docs.walt.id/enterprise-stack/administration/tenants/create
generated: 2026-07-20
---
# Create Tenants

This document outlines how to create a new tenant within an existing organization via the walt.id Enterprise API.
If you don't yet have an organization, please go [here](https://docs.walt.id/enterprise-stack/administration/organizations/create.md) to learn more.

## Create a New Tenant

**Option: CURL**

Endpoint:`/v1/{target}/resource-api/tenants/create` | [API Reference](https://enterprise.sandbox.walt.id/swagger/index.html#/Service%20%7C%20Resource/post_v1__target__resource_api_tenants_create)

**Example Request**

```bash
curl -X 'POST' \
  'https://{orgID}.enterprise-sandbox.waltid.dev/v1/{target}/resource-api/tenants/create' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer {yourToken}' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "My Tenant"
  }'
```

**Body**

```json
{
  "name": "My Tenant"
}
```

**Path Parameters**

- `orgID`: - When performing operations within an organization, it is essential to use the organization's Base URL or
  another valid host alias. For example, if your organization is named `test`, your default Base URL will
  be `test.enterprise-sandbox.walt.dev` when using the sandbox environment.
- `target`: _resourceIdentifier_ - The target indicates the organization in which to create the new tenant and the tenant's
  ID (`{organizationID}.[YourID]`), e.g. `waltid.tenant1`

**Body Parameters**

- `name`: _String_ - Human readable name for the tenant.

---

**Response Codes**

- `201` - Tenant created successfully.