Platform›Organizations / Tenants›Create organization

Create organization

Platform

Create a new organization and initialize its core business identity and governance settings.

Isolation

Tenant-scoped by design

Hierarchy

Organizations + sub-organizations

Access

Membership + role context

Configuration

Policies, modules & branding

POST/v1/organizationsScope: organizations.write

Endpoint summary

Method	Endpoint	Required scope
POST	/v1/organizations	organizations.write

Request body

Field	Type	Required	Description
name	string	Yes	Organization name
type	string	Yes	Organization type
legal_identifier	string	No	Approved external legal identifier
parent_organization_id	string	No	Optional parent organization

Example request

POST /v1/organizationsCopy

POST /v1/organizations
Authorization: Bearer $ACCESS_TOKEN
Content-Type: application/json

{
  "name":"Clinique Centrale",
  "type":"clinic",
  "country":"LU"
}

Example response

201 CreatedCopy

{
  "id":"org_01",
  "name":"Clinique Centrale",
  "type":"clinic",
  "status":"active"
}

Validation

Rule	Behavior
Authorization	Caller must have approved organization administration rights
Uniqueness	Identifiers are server generated and immutable
Ownership	Tenant ownership cannot be forged via request context
Audit	Creation is attributed to the authenticated actor and context