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

# Create Virtual Account

`POST /wallet_accounts/{id}/virtual_accounts`

## Request

- Base URL: `https://sandbox.au-0000.api.assemblypay.com`
- URL: `https://sandbox.au-0000.api.assemblypay.com/wallet_accounts/{id}/virtual_accounts`
- Auth: none declared

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.dev/hellozai/apis/virtual-accounts-and-payids.md) - [All operations](https://skmtc.dev/hellozai/apis/virtual-accounts-and-payids/llms.txt) - [OpenAPI document](https://skmtc.dev/hellozai/apis/virtual-accounts-and-payids/revisions/2c9e638dc4f4?raw)