This request expects a CallbackResponse object from the callback handler. If the callback handler does not respond within 30 seconds, Fireblocks fails the request.
Request parameters
Parameter
Type
Description
requestId
string
A unique identifier of this request. It must be returned in the response.
type
string
The type of configuration request: UNMANAGED_WALLET, EXCHANGE, FIAT_ACCOUNT, ADD_USER, RE_ENROLL_DEVICE, ENABLE_ONE_TIME_ADDRESS, CHANGE_QUORUM_THRESHOLD, ADD_NETWORK_CONNECTION, SET_NETWORK_CONNECTION_ROUTING_POLICY, SET_NETWORK_ID_POLICY, UPDATE_APPROVAL_GROUP_MAPPING, and USERS_GROUP_APPROVAL
extraInfo
object
Additional information about the request, depending on the type:
For UNMANAGED_WALLET, this is an AddressInfo object.
For EXCHANGE or FIAT_ACCOUNT, this is a ThirdPartyInfo object.
Type descriptions
Type
Description
UNMANAGED_WALLET
An event which involves address whitelisting
EXCHANGE
An event which involves adding an exchange to your workspace
FIAT_ACCOUNT
An event which involves adding a Fiat account to your workspace
ADD_USER
An event which involves adding a user to your workspace
RE_ENROLL_DEVICE
An event where an admin re-enrolls a mobile device for one of the users
ENABLE_ONE_TIME_ADDRESS
An event which involves enabling a particular transaction to a one-time address in the workspace
CHANGE_QUORUM_THRESHOLD
An event where the admin updates the quorum threshold
ADD_NETWORK_CONNECTION
An event of adding a Fireblocks Network new connection
SET_NETWORK_CONNECTION_ROUTING_POLICY
An event where the admin configures the routing policy for each network connection
SET_NETWORK_ID_POLICY
An event of setting up the a Fireblocks Network Network ID in case its profile is not discoverable
UPDATE_APPROVAL_GROUP_MAPPING
An event involving gathering a list of approvers for a particular admin operation
USERS_GROUP_APPROVAL
An event which involves approving a new user group in your workspace
Data objects
AddressInfo
The AddressInfo object contains additional information for whitelisting a destination address.
Parameter
Type
Description
subType
string
INTERNAL - Internal Wallets are addresses that you control outside of your Fireblocks workspace. Internal addresses display their current balance and are included in your workspace's total billable address count.
EXTERNAL - External Wallets are addresses managed by your clients and counterparties.
CONTRACT - Contract Wallets are addresses of smart contracts that you want to interact with. Currently, this only applies to smart contracts on EVM-compatible blockchains.
walletName
string
The name of the internal, external, or contract wallet that you want to approve adding an address to.
walletId
object
The ID of the internal, external, or contract wallet that you want to approve adding an address to.
asset
string
The ID of the asset to add to this wallet. Use GET supported assets request to retrieve more information about an asset.
address
string
The asset deposit address requested to add to the wallet.
tag
string
Destination address tag for Ripple; destination memo for EOS, Stellar, Hedera, & DigitalBits; destination note for Algorand; bank transfer description for fiat providers.
Note: For Stellar, the memo must be a string representation of an integer between “0” and “2147483647”. Setting the memo to other values for Stellar assets will result in a failed request with an error message.
ThirdPartyInfo
Parameter
Type
Description
subType
string
The exchange account, fiat account, or unmanaged wallet (INTERNAL, EXTERNAL).
accountName
string
The account's name.
accountId
string
The account's ID.
apiKey
string
The third-party service's API key.
addresses
string
(Optional) A JSON-formatted "key":"value" string, where "key" is an asset symbol and "value" is its address. There can be multiple entries in the JSON. Use supported_assets to retrieve asset symbols.
