---
title: "Master Wallet Account Create"
method: POST
path: "/v2/wallets/{id}/virtual-accounts"
tags: ["Virtual Accounts V2"]
---

# Master Wallet Account Create

`POST /v2/wallets/{id}/virtual-accounts`

## Path parameters

- `id` string, uuid, required

## Request body

- CreateVirtualAccountV2Dto
  - `currency` string, required — ISO 4217 virtual-account currency.
  - `assetId` string, uuid — Stablecoin asset that receives settlements.
  - `customerId` string, uuid — Existing customer identifier, when the provider requires one.
  - `additionalData` object — Values collected and validated against additionalDataSchema.
  - `code` string
  - `passkeyResponse` object
  - `label` string — Your display label for the virtual account.
  - `provider` string, required — Provider slug resolved from the requirements flow.

## Response `201`

Created successfully.

- VirtualAccountCreateResponse
  - `statusCode` integer, required
  - `message` string, required — Human-readable result.
  - `data` VirtualAccountCreateResult, required
    - `created` boolean, required
    - `virtualAccount` VirtualAccount, required
      - `id` string, uuid, required — Virtual account identifier.
      - `reference` string, required — Blockradar virtual-account reference.
      - `accountNumber` string, required — Bank account number.
      - `accountName` string, required — Bank account holder name.
      - `bankName` string, required — Bank name.
      - `bankCode` string, required — Bank or institution code.
      - `currency` string, required — ISO 4217 account currency.
      - `institutionAddress` string, nullable — Institution address.
      - `assetId` string, uuid, required — Stablecoin asset settled to the wallet.
      - `providerId` string, uuid, required — Provider identifier.
      - `isActive` boolean, required
      - `status` string, required — Provider-normalized account status.
      - `type` string, required — Virtual account behavior.
      - `label` string, nullable — Customer-defined label.
      - `createdAt` string, date-time, required — Creation timestamp.
      - `updatedAt` string, date-time, required — Last update timestamp.

---

[API](https://skmtc.net/blockradar/apis/blockradar-documentation.md) · [All operations](https://skmtc.net/blockradar/apis/blockradar-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blockradar/blockradar-documentation/revisions/97f95b4cfc0d/schema)