Skip to main content
POST

Authorizations

Authorization
string
header
required

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

Path Parameters

organization_id
string
required

The unique identifier of the owning organization that will create the tenant

Maximum string length: 24
Pattern: ^[0-9a-f]{24}$

Body

application/json

Unique creation body with conditional fields by type: if type=tenant, requires tenant_config; if type=organization, requires organization_config.

type
enum<string>
required

Creation type. tenant for END CUSTOMER, organization for PARTNER/WHOLESALER.

Available options:
tenant,
organization
name
string
required
Maximum string length: 512
organization_email
string
required
Maximum string length: 512
organization_language
string
required
Maximum string length: 512
organization_country
string
required
Maximum string length: 512
organization_industry
string
required
Maximum string length: 512
tenant_config
object | null

Specific configuration for type=tenant.

organization_config
object | null

Specific configuration for type=organization.

policy_id
string
Maximum string length: 24
Pattern: ^[0-9a-f]{24}$

Response

Tenant and associated organization successfully created. Returns the created tenant resource.

id
string
required
organization_id
string
required

Tenant organization ID

created_at
string<date-time>
required
name
string
required
region
string
required
product_id
string | null

Product ID

policy_id
string | null

Policy ID