Sign in

v2

latestOpenAPI 3.0.12026-07-26334612609.5 KB
Wallets

Creates a new wallet for the user. Note that if the user already has an embedded wallet linked, this call will fail.

Creates a new wallet for the user. Note that this API is not meant for creating embedded wallets. To create embedded wallets use the /embeddedWallets endpoint.

post/environments/{environmentId}/users/{userId}/wallets

Path parameters

environmentIdstring required
Example:95b11417-f18f-457f-8804-68e361f9164f

ID of the environment

userIdstring required
Example:95b11417-f18f-457f-8804-68e361f9164f

UUID of the user

Request body

publicWalletAddressstring required

Valid blockchain wallet address, must be an alphanumeric string without any special characters

chain'ETH' | 'EVM' | 'FLOW' | 'SOL' | 'ALGO' | 'STARK' | 'COSMOS' | 'BTC' | 'ECLIPSE' | 'SUI' | 'SPARK' | 'TRON' | 'APTOS' | 'TON' | 'STELLAR' required
walletNamestring required
walletProvider'browserExtension' | 'custodialService' | 'walletConnect' | 'qrCode' | 'deepLink' | 'embeddedWallet' | 'smartContractWallet' required

Example request

{
  "publicWalletAddress": "0xbF394748301603f18d953C90F0b087CBEC0E1834",
  "walletName": "An example name"
}

Response

Successfully created new wallet for the user

idstring required
namestring required
chain'ETH' | 'EVM' | 'FLOW' | 'SOL' | 'ALGO' | 'STARK' | 'COSMOS' | 'BTC' | 'ECLIPSE' | 'SUI' | 'SPARK' | 'TRON' | 'APTOS' | 'TON' | 'STELLAR' required
publicKeystring required

Valid blockchain wallet address, must be an alphanumeric string without any special characters

provider'browserExtension' | 'custodialService' | 'walletConnect' | 'qrCode' | 'deepLink' | 'embeddedWallet' | 'smartContractWallet' required
lastSelectedAtstring nullable

Example response

{
  "id": "95b11417-f18f-457f-8804-68e361f9164f",
  "name": "An example name",
  "publicKey": "0xbF394748301603f18d953C90F0b087CBEC0E1834",
  "properties": {
    "turnkeySubOrganizationId": "95b11417-f18f-457f-8804-68e361f9164f",
    "turnkeyPrivateKeyId": "95b11417-f18f-457f-8804-68e361f9164f",
    "turnkeyHDWalletId": "95b11417-f18f-457f-8804-68e361f9164f",
    "turnkeyUserId": "95b11417-f18f-457f-8804-68e361f9164f"
  }
}