---
title: "Create a new tenant within an omnibus structure"
method: POST
path: "/v1/domains/{domainId}/omnibus/{omnibusId}/tenants"
tags: ["Tenants"]
---

# Create a new tenant within an omnibus structure

`POST /v1/domains/{domainId}/omnibus/{omnibusId}/tenants`

## Path parameters

- `domainId` string, uuid, required
- `omnibusId` string, uuid, required

## Request body

- OmnibusCreateOrUpdateTenantRequest
  - `alias` string, required — Alias for the tenant within the omnibus structure
  - `description` string — Optional description for the tenant (max 250 characters)
  - `status` 'LOCKED' | 'UNLOCKED'
  - `customProperties` OmnibusJsonNullableListTenantCustomProperty
    - `present` boolean

## Response `201`

Tenant created

- OmnibusTenantResponse
  - `id` string, uuid, required — Unique identifier of the tenant
  - `omnibusId` string, uuid, required — Identifier of the omnibus structure this tenant belongs to
  - `alias` string, required — Alias of the tenant
  - `isHost` boolean, required — Whether this tenant is the host tenant of the omnibus structure. This field is immutable and set at creation time.
  - `status` 'LOCKED' | 'UNLOCKED', required
  - `createdAt` string, date-time, required — Timestamp when the tenant was created
  - `updatedAt` string, date-time, required — Timestamp when the tenant was last updated
  - `balances` OmnibusTenantBalanceEntry[] — Balances per ticker/ledger combination
    - `tickerId` string, uuid, required — Ticker identifier
    - `ledgerId` string, required — Ledger identifier
    - `reserved` string, required — Reserved amount
    - `quarantined` string, required — Quarantined amount
    - `availableBalance` string — Available balance from accounting service; absent if the accounting service is unavailable
  - `description` string — Description of the tenant
  - `customProperties` OmnibusTenantCustomProperty[] — Custom key-value properties
    - `key` string, required — Property key
    - `value` string, required — Property value

## Other responses

- `404` — Domain or omnibus structure not found
- `409` — Omnibus structure is not operational (must be ACTIVE and UNLOCKED)

---

[API](https://skmtc.net/ripple/apis/ripple-custody-api.md) · [All operations](https://skmtc.net/ripple/apis/ripple-custody-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ripple/ripple-custody-api/revisions/410038300d74/schema)