FIfireblocks
Vaults

Create a new vault account

Creates a new vault account with the requested name. **Note: ** Vault account names should consist of ASCII characters only. Learn more about Fireblocks Vault Accounts in the following guide. Endpoint Permission: Admin, Non-Signing Admin, Signer, Approver, Editor.

post/vault/accounts

Request

Headers

Idempotency-Keystring

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.

Request body

namestring

Account Name

hiddenOnUIboolean

Optional - if true, the created account and all related transactions will not be shown on Fireblocks console

customerRefIdstring

Optional - Sets a customer reference ID

autoFuelboolean

Optional - Sets the autoFuel property of the vault account

vaultType'MPC' | 'KEY_LINK'

Type of vault account. The default type will be set to MPC. If the workspace does not support the selected type, it will return an error.

autoAssignboolean

Applicable only when the vault account type is KEY_LINK. For MPC, this parameter will be ignored. If set to true and there are available keys, random keys will be assigned to the newly created vault account. If set to true and there are no available keys to be assigned, it will return an error. If set to false, the vault account will be created without any keys.

Response

A Vault Account object

idstring
namestring
hiddenOnUIboolean
customerRefIdstring
autoFuelboolean

Example response

{
  "tags": [
    {
      "id": "df4c0987-30da-4976-8dcf-bc2dd41ae331",
      "label": "VIP",
      "description": "Tag for VIP customers",
      "color": "#FF5733",
      "updatedAt": 1717084800000,
      "allowedEntityTypes": [
        "vault_account"
      ],
      "pendingApprovalRequest": {
        "id": "12345"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.