---
title: "CreateWallet"
method: POST
path: "/v2/vaults/{vault_id}/wallets"
tags: ["Wallets"]
---

# CreateWallet

`POST /v2/vaults/{vault_id}/wallets`

Create a new wallet.

## Path parameters

- `vault_id` string, required

## Request body

- V2Wallet
  - `name` string — The resource name of the wallet. Format: `vaults/{vault_id}/wallets/{wallet_id}`
  - `displayName` string, required — A human-readable name. Must match the regular expression `[a-zA-Z0-9\.,:\-'# _$]+$` and be shorter than 100 characters
  - `external` boolean — Whether this wallet is external. External wallets are wallets that are not managed by Utila.
  - `archived` boolean — Whether this wallet is archived.
  - `convertedValue` V2ConvertedValue — A message representing a converted value.
    - `amount` string — The amount in USD.
    - `currencyCode` string — The currency code of the amount. Always USD.
  - `hasFrozenAssets` boolean — Some of the assets in this wallet are frozen due to a AML policy. Included only when `FULL` view is requested.
  - `networks` string[], required — The resource names of the networks of the wallet. Can be set during creation and can be added later through the `CreateWalletAddress` method.
  - `evmDetails` V2WalletEVMDetails
    - `address` string — The address of the wallet.
  - `tronDetails` WalletTronDetails
    - `address` string — The address of the wallet.
  - `tonDetails` V2WalletTonDetails
    - `address` string — The address of the wallet.
  - `solanaDetails` WalletSolanaDetails
    - `address` string — The address of the wallet.
  - `xrplDetails` WalletXRPLDetails
    - `signingPubKey` string — The public key of the wallet, hex-encoded as expected by XRPL. For ed25519 keys this starts with `ED`.
  - `createParams` WalletCreateParams — Parameters only used during wallet creation.
    - `walletGroups` string[] — Wallet will be assigned to these wallet groups upon creation. Each group must support assignment of empty wallets on creation in the dedicated group setting. Format: `vaults/{vault_id}/walletGroups/{wallet_group_id}`.
  - `btcDetails` V2WalletBTCDetails
    - `btcNetworkDetails` V2WalletBTCDetailsBTCNetworkDetails[]
      - `network` string — A specific btc network of the wallet.
      - `mainAddress` string — The main deposit address of the wallet in the network.
      - `xpub` string — The xpub of the wallet in the network. Included only when `FULL` view is requested.

## Response `200`

A successful response.

- V2CreateWalletResponse
  - `wallet` V2Wallet
    - `name` string — The resource name of the wallet. Format: `vaults/{vault_id}/wallets/{wallet_id}`
    - `displayName` string, required — A human-readable name. Must match the regular expression `[a-zA-Z0-9\.,:\-'# _$]+$` and be shorter than 100 characters
    - `external` boolean — Whether this wallet is external. External wallets are wallets that are not managed by Utila.
    - `archived` boolean — Whether this wallet is archived.
    - `convertedValue` V2ConvertedValue — A message representing a converted value.
      - `amount` string — The amount in USD.
      - `currencyCode` string — The currency code of the amount. Always USD.
    - `hasFrozenAssets` boolean — Some of the assets in this wallet are frozen due to a AML policy. Included only when `FULL` view is requested.
    - `networks` string[], required — The resource names of the networks of the wallet. Can be set during creation and can be added later through the `CreateWalletAddress` method.
    - `evmDetails` V2WalletEVMDetails
      - `address` string — The address of the wallet.
    - `tronDetails` WalletTronDetails
      - `address` string — The address of the wallet.
    - `tonDetails` V2WalletTonDetails
      - `address` string — The address of the wallet.
    - `solanaDetails` WalletSolanaDetails
      - `address` string — The address of the wallet.
    - `xrplDetails` WalletXRPLDetails
      - `signingPubKey` string — The public key of the wallet, hex-encoded as expected by XRPL. For ed25519 keys this starts with `ED`.
    - `createParams` WalletCreateParams — Parameters only used during wallet creation.
      - `walletGroups` string[] — Wallet will be assigned to these wallet groups upon creation. Each group must support assignment of empty wallets on creation in the dedicated group setting. Format: `vaults/{vault_id}/walletGroups/{wallet_group_id}`.
    - `btcDetails` V2WalletBTCDetails
      - `btcNetworkDetails` V2WalletBTCDetailsBTCNetworkDetails[]
        - `network` string — A specific btc network of the wallet.
        - `mainAddress` string — The main deposit address of the wallet in the network.
        - `xpub` string — The xpub of the wallet in the network. Included only when `FULL` view is requested.

---

[API](https://skmtc.dev/utila/apis/utila-api.md) · [All operations](https://skmtc.dev/utila/apis/utila-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/utila/utila-api/revisions/b4f35b3a1e96/schema)