POST
/v1/mgmt/tenant/create

Create a new tenant, using a valid management key.

This API endpoint will create a new tenant utilizing a valid management key.

Creation of a new tenant can set the name, id, and selfProvisioningDomains. The id and selfProvisioningDomains are not mandatory. The id will be autogenerated if not provided. The response will always include the tenantId.

Next Steps

See also

Endpoint Authentication

Use authorization bearer header with the following format:

Authorization: Bearer \<ProjectId:ManagementKey\>

Try it

/v1/mgmt/tenant/create

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

< Project ID >:< Management Key > as bearer

In: header

Request Body

namestring

idstring

selfProvisioningDomainsarray<string>

customAttributesobject

authTypestring

Status codeDescription
200OK
curl -X POST "https://api.descope.com/v1/mgmt/tenant/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <ProjectId:ManagementKey>" \
  -d '{
  "name": "string",
  "id": "string",
  "selfProvisioningDomains": [
    "string"
  ],
  "customAttributes": {},
  "authType": "string"
}'

{
  "id": "string"
}

Was this helpful?