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

# Master Wallet Create

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

This endpoint is used to create a new virtual account within a specific master wallet.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| firstname | string | Yes | Customer's first name |
| lastname | string | Yes | Customer's last name |
| email | string | Yes | Customer's email address (must be unique per business) |
| phone | string | No | Customer's phone number in format: +234XXXXXXXXXX |
| bvn | string | Yes | Customer's Bank Verification Number |
| dateOfBirth | string | Yes | Customer's date of birth in yyyy-MM-dd format |

## Request body

- object
  - `bvn` string, required
  - `dateOfBirth` string, required
  - `email` string, required
  - `firstname` string, required
  - `lastname` string, required
  - `phone` string

## Response `201`

200

- object
  - `data` object
    - `accountName` string
    - `accountNumber` string
    - `address` unknown
    - `bankCode` string
    - `bankName` string
    - `createdAt` string
    - `currency` string
    - `customer` object
      - `createdAt` string
      - `email` string
      - `id` string
      - `name` string
      - `network` string
      - `phone` string
      - `status` string
      - `updatedAt` string
    - `id` string
    - `isActive` boolean
    - `reference` string
    - `status` string
    - `type` string
    - `updatedAt` string
    - `wallet` object
      - `address` string
      - `configurations` unknown
      - `createdAt` string
      - `derivationPath` string
      - `description` string
      - `id` string
      - `isActive` boolean
      - `name` string
      - `network` string
      - `status` string
      - `updatedAt` string
  - `message` string
  - `statusCode` number

---

[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/versions/97f95b4cfc0d/schema)