Skip to main content
POST
/
platform
/
admin
/
tenant
cURL
curl --request POST \
  --url https://api.example.com/platform/admin/tenant \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Acme Corporation",
  "tenantAdminEmail": "[email protected]",
  "creatorUserId": 1
}
'
{
  "isSuccess": true,
  "isFailure": false,
  "error": null,
  "value": {
    "id": 42,
    "name": "Example"
  }
}

Query Parameters

​
api-version
string | null

Body

application/json

Request to create a new tenant organization.

​
name
string

Name of the tenant organization.

Example:

"Acme Corporation"

​
tenantAdminEmail
string

Email address of the tenant administrator.

Example:

"[email protected]"

​
creatorUserId
integer<int64>

Identifier of the platform user creating the tenant.

Example:

1

Response

Wrapper for API operation results containing success status, error information, and return value.

​
isSuccess
boolean

True if the operation completed successfully, false otherwise.

Example:

true

​
isFailure
boolean

True if the operation failed, false otherwise.

Example:

false

​
error
object

Error information returned when the operation fails.

Example:
{
  "code": "ValidationError",
  "message": "The request parameters failed validation.",
  "info": [
    "The Name field is required.",
    "The Id field must be greater than 0."
  ]
}
​
value
object

The result value returned when the operation is successful.

Example:
{
  "id": 42,
  "name": "Acme Corporation",
  "accountsCount": 5,
  "configurationsCount": 12,
  "walletsCount": 8,
  "pendingUsersCount": 2,
  "activeUsersCount": 15,
  "isEnabled": true,
  "firstAdminPendingEmail": "[email protected]"
}