---
title: "Create virtual IBAN"
method: POST
path: "/v1/accounts/{account_id}/virtual_ibans"
tags: ["Virtual IBANs"]
---

# Create virtual IBAN

`POST /v1/accounts/{account_id}/virtual_ibans`

Creates a new virtual IBAN and attaches it to the account specified in the request.

## Path parameters

- `account_id` string, required

## Request body

- VirtualIbanCreateRequest
  - `customer_id` string — Customer data related to the issued Virtual IBAN. Optional if partner configuration allows issuing vIBANs without customer.
  - `reference` string, uuid, required — Partners must generate a reference for the vIBAN and supply it in this property. This property acts as an idempotency key and must be unique.
  - `description` string — A description of the vIBAN. Visible to the customer.

## Response `200`

The virtual IBAN was already created.

## Other responses

- `201` — The virtual IBAN was created successfully.
- `400` — An error occurred on the client side.
- `403` — You are not authorized to perform this action.
- `500` — Internal server error.

---

[API](https://skmtc.net/solarisgroup/apis/account-management.md) · [All operations](https://skmtc.net/solarisgroup/apis/account-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarisgroup/account-management/revisions/099ef636a5a1/schema)