Generate new virtual account

post

https://api.sandbox.com/v1/beneficiaries/{beneficiaryId}/virtualAccounts

Creates a new virtual account for the beneficiary in the specified currency and region. Virtual accounts enable beneficiaries to receive funds through unique account identifiers (account number + routing number) without having an actual bank account. Each virtual account is tied to a specific currency and can receive deposits via supported payment rails. You can create multiple virtual accounts per beneficiary for different currencies.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

beneficiaryId

string

required

Unique identifier of the beneficiary to create virtual account for.

Body Params

Request to create a virtual account for a beneficiary to receive payments. Multiple virtual accounts can be created for the same beneficiary with the same title. Use the optional label field to distinguish between them.

suffix

string

Optional suffix appended to the beneficiary name to form the account title (e.g., name_suffix). If omitted or empty, the account title will be the beneficiary name only.

defaultPayor

boolean

Whether this virtual account should be the default payor for the beneficiary. The first virtual account created is automatically set as the default payor.

label

string

Optional label to help distinguish between multiple virtual accounts for the same beneficiary (e.g., "Payroll", "Vendor Payments"). Stored on Caliza's side and returned in GET responses. Not sent to the banking provider.

Response

204

No Content