Create a virtual account
Create a new balance-bearing virtual account inside an accessible non-Global USD bank Account. Global USD Accounts are not eligible. The parent Account must be provided because a legal entity can have more than one. The virtual account starts with a zero balance. Use its id as fromAccount or toAccount in a per-rail transfer create endpoint.
Authorizations
User API key authentication. Create a key under Settings → API keys in the Slash dashboard (https://app.slash.com/global-settings/api-keys) and send the x-legal-entity header naming the legal entity to act on with every request. Keys scoped to a legal entity are rejected with 403 user_api_key_required.
Headers
Unique caller-generated key for one create request. Once an authenticated, schema-valid request reaches the operation, the key is permanently consumed for that operation and legal entity whether the operation succeeds or fails. Reusing it in that scope returns 409 and never replays a response, unlike API v1, which replays the original response for a matching key.
1 - 255The legal entity to act on. Required on every request; a user API key can act on any legal entity its user has access to.
^le_[a-zA-Z0-9]+$Body
Create a balance-bearing virtual account inside an accessible, non-Global USD bank Account.
Parent non-Global USD bank Account for the new virtual account. This is required even when the legal entity currently has only one Account.
"sa_group_primary123"
Display name for the virtual account.
1 - 255"Payroll"
Optionally divert funds from this virtual account to its Account's primary virtual account.
- Flat fee
- Take rate
Response
The created virtual account.
A balance-bearing virtual account. Virtual accounts in eligible bank Accounts can source or receive API v2 transfers; Global USD virtual accounts are readable but cannot be used by the API v2 transfer endpoints.
Virtual account id with the subaccount_ prefix.
Parent Account id with the sa_group_ prefix.
primary, default open, closed Current ledger balance. Zero for a newly created virtual account.
Funds diverted to the Account's primary virtual account.
- Flat fee
- Take rate