メインコンテンツへスキップ
POST
https://{teamSlug}.teams.auth0.com
/
api
/
tenants
Create a tenant under the current team
curl --request POST \
  --url https://{teamSlug}.teams.auth0.com/api/tenants \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "admin_email": "jsmith@example.com",
  "locality": "<string>",
  "tenant_name": "<string>",
  "environment_tag": "development"
}
'
{
  "tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "tenant_name": "<string>",
  "domain": "<string>",
  "locality": "<string>",
  "environment": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "management_client": {
    "client_name": "<string>",
    "client_id": "<string>",
    "client_secret": "<string>"
  },
  "environment_tag": "development"
}

Documentation Index

Fetch the complete documentation index at: https://docs-dev.auth0-mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

承認

Authorization
string
header
必須

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

ボディ

application/json

Create a tenant under the current team

admin_email
string<email>
必須

The email of the person that will be added as an admin of the tenant. The person must be a member of the team.

locality
string
必須

Specifies the Auth0 Public Cloud locality where the tenant will be created.
Available localities include United States (us), Europe (eu), Australia (au), Japan (jp), Canada (ca) and United Kingdom (uk).

Required string length: 2 - 5
:

"us"

"eu"

"au"

"jp"

"ca"

"uk"

tenant_name
string

The tenant name uniquely identifies a tenant programmatically and within various dashboards, such as Auth0 Dashboard. It can only contain alphanumeric characters, lowercase letters and "-". However, it can't start nor end with "-". If not specified, a tenant name will be auto-generated.

Required string length: 3 - 63
Pattern: ^[a-z0-9][-a-z0-9]{1,62}[a-z0-9]$
:

"acme-development-tenant"

environment_tag
enum<string>
デフォルト:development

Specifies the Environment tag for the tenant created in the Auth0 Public Cloud. It is used to distinguish between development, staging and production environments.
Development and Staging environments are intended for testing and pre-production use, while production is designated for live applications and subject to higher rate limits. Selecting the correct environment type ensures appropriate resource allocation and rate limits

利用可能なオプション:
development,
production,
staging
:

"development"

レスポンス

Tenant Created

tenant_id
string<uuid>
必須

The unique identifier of the created tenant (UUID). This identifier is required for performing operations such as deleting the tenant. UUIDs ensure global uniqueness and are essential for managing tenant resources programmatically

:

"538c9e21-e3d5-4ad6-b3d0-352c62369fb0"

tenant_name
string
必須

The tenant name uniquely identifies a tenant programmatically and within various dashboards, such as Auth0 Dashboard. It can only contain alphanumeric characters, lowercase letters and "-". However, it can't start nor end with "-". If not specified, a tenant name will be auto-generated.

Required string length: 3 - 63
Pattern: ^[a-z0-9][-a-z0-9]{1,62}[a-z0-9]$
:

"acme-development-tenant"

domain
string
必須

The fully qualified domain name of the tenant, which uniquely identifies its domain within the system. The domain is used to define the audience when interacting with the Management API, enabling programmatic management of the tenant’s configuration and resources.

:

"acme-development-tenant.us.auth0.com"

"acme-development-tenant.acme-dev.auth0app.com"

locality
string
必須

Locality in which the tenant was created

:

"us"

"eu"

"virginia"

"frankfurt"

environment
string
必須

The name of the cloud environment where the tenant was created

:

"US-3"

"EU-1"

"acme-dev"

created_at
string<date-time>
必須

The date and time when the tenant was created, formatted in ISO 8601 standard. This timestamp ensures consistency across time zones and systems

management_client
object
必須

The Auth0 Management Client credentials required to authenticate and interact with the newly created tenant. These credentials allow authorized access to manage the tenant's configuration, resources, and API interactions.

environment_tag
enum<string>

Specifies the Environment tag for the tenant created in the Auth0 Public Cloud. It is used to distinguish between development, staging and production environments.
Development and Staging environments are intended for testing and pre-production use, while production is designated for live applications and subject to higher rate limits. Selecting the correct environment type ensures appropriate resource allocation and rate limits

利用可能なオプション:
development,
production,
staging
:

"development"