Bulk creation of new vault accounts

Create multiple vault accounts by running an async job.

• The HBAR, TON, SUI, TERRA, ALGO, and DOT blockchains are not supported.
• These endpoints are currently in beta and might be subject to changes.
• Limited to a maximum of 10,000 accounts per operation.

Endpoint Permissions: Admin, Non-Signing Admin, Signer, Approver, Editor.

POST /vault/accounts/bulk

TypeScript

TypeScript

const response: Promise<FireblocksResponse<JobCreated>> = fireblocks.vaults.createMultipleAccounts(vaultsApiCreateMultipleAccountsRequest);

200

{
  "jobId": "<string>",
  "approvalRequestId": "<string>"
}

Headers

Idempotency-Key · string

A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours.

Body

application/json

count · integer · required

Count

Example:

1000

baseAssetIds · string[] · required

Array of base asset IDs

Example:

["BTC", "ETH", "SOL"]

names · string[]

Names to assign to vault accounts. if vaultAccountNamesStartingIndex or prefix is used it'll fail

Example:

[
  "first va",
  "client 65502e71-ecdf-48da-a074-c1753befc7fb"
]

vaultAccountNamesStartingIndex · integer

Copy vault accounts names starting from this index. If names array is used it'll fail

Example:

0

prefix · string

When copying from existing vault accounts (vaultAccountNamesStartingIndex) then adding a prefix to the names. If names array is used it'll fail

Example:

"Copied from: "

tagIds · string<uuid>[]

Optional list of tag IDs to attach to all created vault accounts

Maximum array length: 20

Example:

[
  "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "b2c3d4e5-f6a7-8901-bcde-f12345678901"
]

Response

200

application/json

A JobCreated object

jobId · string

approvalRequestId · string

Approval request ID. Returned when a tag triggers an approval flow.