#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 to learn more.

#Create a New Tenant

CURL

Endpoint:/v1/{target}/resource-api/tenants/create | API Reference

Example Request

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

{
  "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.

Last updated on July 22, 2025

Overview Overview