---
title: "Create a new vault account"
method: POST
path: "/vault/accounts"
tags: ["Vaults"]
---

# Create a new vault account

`POST /vault/accounts`

## Request

- Base URL: `https://api.fireblocks.io/v1`
- URL: `https://api.fireblocks.io/v1/vault/accounts`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fireblocks/apis/fireblocks-api/docs/vault/accounts/post.ts> (a function with typed inputs; its response is checked against the schema)

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](https://developers.fireblocks.com/reference/create-vault-account).
Endpoint Permission: Admin, Non-Signing Admin, Signer, Approver, Editor.

## Headers

- `Idempotency-Key` string

## Request body

- CreateVaultAccountRequest
  - `name` string: Account Name
  - `hiddenOnUI` boolean: Optional - if true, the created account and all related transactions will not be shown on Fireblocks console
  - `customerRefId` string: Optional - Sets a customer reference ID
  - `autoFuel` boolean: 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.
  - `autoAssign` boolean: 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 `200`

A Vault Account object

- VaultAccount
  - `id` string
  - `name` string
  - `assets` VaultAsset[]
    - `id` string
    - `total` string: The total wallet balance. In EOS this value includes the network balance, self staking and pending refund. For all other coins it is the balance as it appears on the blockchain.
    - `balance` string: Deprecated - replaced by "total"
    - `available` string: Funds available for transfer. Equals the blockchain balance minus any locked amounts
    - `pending` string: The cumulative balance of all transactions pending to be cleared
    - `frozen` string: The cumulative frozen balance
    - `lockedAmount` string: Funds in outgoing transactions that are not yet published to the network
    - `staked` string: Staked balance
    - `totalStakedCPU` string: Deprecated
    - `totalStakedNetwork` string: Deprecated
    - `selfStakedCPU` string: Deprecated
    - `selfStakedNetwork` string: Deprecated
    - `pendingRefundCPU` string: Deprecated
    - `pendingRefundNetwork` string: Deprecated
    - `blockHeight` string
    - `blockHash` string
    - `rewardsInfo` RewardsInfo
      - `pendingRewards` string: Amount that is pending for rewards
  - `hiddenOnUI` boolean
  - `customerRefId` string
  - `autoFuel` boolean
  - `tags` Tag[]: List of tags attached to the vault account
    - `id` string, uuid, required: The unique identifier of the tag
    - `label` string, required: The tag label
    - `description` string: Description for the tag
    - `color` string: The tag color in hex format
    - `isProtected` boolean, required: Indication if the tag is a protected tag
    - `updatedAt` number, required: The date and time the tag was last updated
    - `type` 'WALLET_POOL': The tag type, indicating the domain that owns the tag
    - `allowedEntityTypes` string[]: The entity types this tag may be attached to. Tags created before this field was introduced read back as ['vault_account']. Known values: vault_account (default), contact.
    - `pendingApprovalRequest` ApprovalRequest: Approval request details
      - `id` string, numeric, required: The approval request identifier
      - `type` 'TAG_UPDATE' | 'TAG_DELETE' | 'TAG_ATTACH_DETACH', required: The approval request type
      - `state` 'PENDING' | 'APPROVED' | 'REJECTED' | 'FAILED' | 'CANCELLED' | 'EXPIRED', required: The approval request state

## Other responses

- `default`: Error Response

---

[API](https://skmtc.dev/fireblocks/apis/fireblocks-api.md) - [All operations](https://skmtc.dev/fireblocks/apis/fireblocks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireblocks/apis/fireblocks-api/revisions/4eba9965659a?raw)