Create Account

Creates/onboards a Solana Account on the Vulcan Forge system and onchain (optional). Use the itemData.alreadyOnchain=true setting to only onboard the account into Vulcan Forge but not submit a Solana transaction to create the account on the network (because the account would already be on the network).

The itemData.managed indicates if Vulcan Forge has access to the account's private key or not.

IMPORTANT NOTE: if the dataLength is specified for the account, space will be reserved on the blockchain based on this parameter. Also for all accounts owned by the System Program, any SOL seeded into the account cannot be transferred out if dataLength > 0.

See the the offchainReferences.type field for the different types of accounts supported on Vulcan Forge. Note that for the following types more specialized endpoints can/need to be used to create the accounts:

Account Type	Enpoint to Use
FUNDS_TOKEN_ACCOUNT and ASSET_TOKEN_ACCOUNT	Initialize Position
FUNDS_TOKEN or ASSET_TOKEN	Optional - the mint account for a token can be created with the Create Financial Instrument endpoint directly or it can be created with the Create Account endpoint
ADDRESS_LOOKUP_TABLE	Create Address Lookup Table
NONCE	Create Durable Nonce Accounts

The VULCAN_FORGE_UPDATE_DEBIT_API_KEYS role is required to allow the API Key to change the solDebitApiKeys or tokenDebitApiKeys fields.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request POST 'https://vf-solana-api.dev.alphaledger.com/api/v1/accounts?solanaClusterId=SOLANA_DEVNET' \ --header 'x-request-id: f9860f73-a466-41f2-a083-34eeb1cc3a3c' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '// Managed - Not yet onchain (Token Management Authority) { "itemData": { "managed": true, "alreadyOnchain": false, "comments": "Account which should be used as Update Authority with a Token 2022 Token", "privateKeyDetails": { "location": [ "DATABASE" ] }, "offchainReferences": { "code": "update-db", "type": "TOKEN_MANAGEMENT_AUTHORITY", "organizationExternalId": "ALIM" } } }'

{ "newAccount": { "onchainId": "ndA7eTfoWqrczXYUq53gNRRjQgEmufqErXbgXUFFUAA", "offchainId": "1a1e904d-0d95-4e66-85e1-88a57774e910" }, "solanaTransaction": { "success": false, "offchainId": "ee36c656-aa74-4d6a-b23c-332c204cb202", "status": "SIGNED", "onchainId": "5nwo7XvhiVRpJasEzH5r3hGKJqaTxd7qVit3cedFJgESdAPrmawebMJu6fUKRfjXEaivuey7vBsW56xPxX76T1bm", "confirmationsCount": 2, "serializedMessage": "string", "errorMessage": "string", "txnTimestamp": "2025-10-21T16:17:45.035372Z" } }

Request

Responses