---
title: "Create a deposit wallet for a tenant on first request"
method: POST
path: "/v1/domains/{domainId}/omnibus/{omnibusId}/tenants/{tenantId}/deposit-wallet"
tags: ["Deposits"]
---

# Create a deposit wallet for a tenant on first request

`POST /v1/domains/{domainId}/omnibus/{omnibusId}/tenants/{tenantId}/deposit-wallet`

## Path parameters

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

## Response `200`

Deposit wallet already exists

- OmnibusDepositWalletResponse
  - `depositWalletId` string, uuid, required — Unique identifier of the deposit wallet
  - `custodyAccountId` string, uuid, required — Identifier of the custody account backing this deposit wallet
  - `status` 'CREATING' | 'ACTIVE' | 'INACTIVE', required
  - `addresses` OmnibusDepositAddress[], required — List of deposit addresses, one per ledger. Empty when status is CREATING.
    - `ledgerId` string, required — Identifier of the blockchain ledger
    - `address` string, required — Blockchain address for receiving deposits

## Other responses

- `201` — Deposit wallet created
- `404` — Tenant not found

---

[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)
