---
title: "Create Virtual Account"
method: POST
path: "/wallet_accounts/{id}/virtual_accounts"
tags: ["Virtual Accounts"]
---

# Create Virtual Account

`POST /wallet_accounts/{id}/virtual_accounts`

Create a _Virtual Account_ for a given _Wallet Account_.

## Path parameters

- `id` string, uuid, required

## Request body

- CreateVirtualAccountRequest
  - `account_name` string — A name given for a _Virtual Account_. This is used in CoP lookups.
  - `aka_names` AkaName[] — A list of AKA Names.

## Response `202`

Accepted

- VirtualAccount
  - `id` string, uuid
  - `routing_number` string, numeric
  - `account_number` string, numeric
  - `currency` string, alphabets
  - `user_external_id` string, uuid
  - `wallet_account_id` string, uuid
  - `status` 'active' | 'pending_activation' | 'activation_failed' | 'disabled' | 'closed'
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `account_type` 'NIND'
  - `full_legal_account_name` string
  - `account_name` string — A name given for a _Virtual Account_. This is used in CoP lookups.
  - `aka_names` AkaName[] — A list of AKA Names.
  - `merchant_id` string — An identifier that links a _Virtual Account_ to a merchant. This is used in CoP lookups.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `500` — Internal Server Error

---

[API](https://skmtc.net/hellozai/apis/assembly-api.md) · [All operations](https://skmtc.net/hellozai/apis/assembly-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hellozai/assembly-api/revisions/60b528b2e015/schema)