API

Create new MSP child tenant

post
https://core-api.ternary.app/api/tenants

Create a new child tenant under an MSP parent. The parent is specified via parentTenantID in the request body; the authenticated caller must have global CREATE_TENANT permission; MSP-admin permission on the parent alone is insufficient.

The type field should be set to MSP_CUSTOMER for child tenants managed by the MSP parent.

New child tenants are created in the ACTIVE state. Use the update endpoint to suspend (INACTIVE) or reactivate later.

After creation, use the MSP Tenant Settings endpoints to configure feature access for the child.

See MSP Customer Management for detailed MSP administration guidance.

Body Params
uuid
required
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Parent MSP tenant ID. Creation requires the global CREATE_TENANT permission; parent-admin access alone is insufficient.

string
required
length ≥ 1

Tenant email domain

string
required
length ≥ 1

Tenant name

string
enum
required
Defaults to USD

Preferred Tenant currency code

string
enum
required

Tenant type (must be MSP_CUSTOMER for child tenants)

Allowed:
Responses

Updated 6 months ago

Did this page help you?
Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 6 months ago

Did this page help you?