> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usenumero.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Customer Virtual Account

> Create a virtual NUBAN account for an individual customer. Requires basic KYC information.

Create a virtual NUBAN account for an individual customer. Requires basic KYC information.

## Endpoint

```
POST /api/v1/business/virtualaccount/customer
```

**Signature required:** Yes

## Headers

| Header                       | Required | Description                                                                                                                                                                    |
| ---------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `X-Numero-Api-Key`           | Yes      | Your API key                                                                                                                                                                   |
| `X-Numero-Signature`         | Yes      | Base64 HMAC-SHA256 over the exact raw request body (POST) or the canonicalised query string (GET), keyed with your **Public Key**. See [Request signing](/03-request-signing). |
| `X-Numero-Signature-Version` | Yes      | Always `v2`.                                                                                                                                                                   |

## Request body

| 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            |
| `mobileNumber` | string | Yes      | Customer's phone number             |
| `bvn`          | string | Yes      | Customer's Bank Verification Number |

## Request example

```bash theme={null}
curl -X POST "https://api.usenumero.com/numeroaccount/api/v1/business/virtualaccount/customer" \
  -H "Content-Type: application/json" \
  -H "X-Numero-Api-Key: your_api_key" \
  -H "X-Numero-Signature: $SIGNATURE" \
  -H "X-Numero-Signature-Version: v2" \
  -d '{
    "firstName": "John",
    "lastName": "Doe",
    "email": "john.doe@example.com",
    "mobileNumber": "08012345678",
    "bvn": "12345678901"
  }'
```

## Response

```json theme={null}
{
  "data": {
    "reference": "VA-20240115-abc123",
    "accountName": "John Doe",
    "accountNumber": "8012345678",
    "bankName": "Providus Bank",
    "providerCode": "PROVIDUS"
  },
  "error": null,
  "meta": {
    "request_id": "req_365123ebc73323f1482508560ce6400e",
    "pagination": null
  }
}
```

| Field           | Type   | Description                                              |
| --------------- | ------ | -------------------------------------------------------- |
| `reference`     | string | Unique reference for this virtual account                |
| `accountName`   | string | The name on the virtual account                          |
| `accountNumber` | string | The NUBAN account number — share this with your customer |
| `bankName`      | string | The bank the account was created with                    |
| `providerCode`  | string | Provider identifier                                      |