Documentation | Wallets › Create Wallets With An Associated Recovery User

API Reference

Wallets

wallets

Methods

Obtain A User Session Signer To Enable Wallet Access -> { encrypted_authorization_key, expires_at, wallets } | { authorization_key, expires_at, wallets }

post/v1/user_signers/authenticate

Obtain a user session signer to enable wallet access.

Create Wallet ->

Wallet

post/v1/wallets

Create a new wallet.

header Parameters

privy-authorization-signature: string

Optional

Request authorization signature. If multiple signatures are required, they should be comma separated.

Response fields

Wallet

Request example

curl https://api.privy.io/v1/wallets \
    -H 'Content-Type: application/json' \
    -H "Authorization: Basic $PRIVY_APP_ID:$PRIVY_APP_SECRET" \
    -d '{
      "chain_type": "ethereum"
    }'

200Example

{
  "id": "id2tptkqrxd39qo9j423etij",
  "additional_signers": [
    {
      "signer_id": "signer_id"
    }
  ],
  "address": "0xF1DBff66C993EE895C8cb176c30b07A559d76496",
  "chain_type": "ethereum",
  "created_at": 1741834854578,
  "policy_ids": [
    "string"
  ],
  "owner_id": "rkiz0ivz254drv1xw982v3jq",
  "public_key": "public_key"
}

Create Wallets With An Associated Recovery User -> { recovery_user_id, wallets }

post/v1/wallets_with_recovery

Create wallets with an associated recovery user.

Response fields

recovery_user_id: string

The ID of the created user.

wallets: Array<

Wallet

The wallets that were created.

Request example

curl https://api.privy.io/v1/wallets_with_recovery \
    -H 'Content-Type: application/json' \
    -H "Authorization: Basic $PRIVY_APP_ID:$PRIVY_APP_SECRET" \
    -d '{
      "primary_signer": {
        "subject_id": "cm7oxq1el000e11o8iwp7d0d0"
      },
      "recovery_user": {
        "linked_accounts": [
          {
            "address": "[email protected]",
            "type": "email"
          }
        ]
      },
      "wallets": [
        {
          "chain_type": "ethereum",
          "policy_ids": [
            "xxxxxxxxxxxxxxxxxxxxxxxx"
          ]
        },
        {
          "chain_type": "solana",
          "policy_ids": [
            "xxxxxxxxxxxxxxxxxxxxxxxx"
          ]
        }
      ]
    }'

200Example

{
  "recovery_user_id": "so6bsadjfi3ihhkyt9hlqv6x",
  "wallets": [
    {
      "id": "ubul5xhljqorce73sf82u0p3",
      "additional_signers": [
        {
          "signer_id": "signer_id"
        }
      ],
      "address": "0x3DE69Fd93873d40459f27Ce5B74B42536f8d6149",
      "chain_type": "ethereum",
      "created_at": 1744300912643,
      "policy_ids": [
        "string"
      ],
      "owner_id": "lzjb3xnjk2ntod3w1hgwa358",
      "public_key": "public_key"
    },
    {
      "id": "sb4y18l68xze8gfszafmyv3q",
      "additional_signers": [
        {
          "signer_id": "signer_id"
        }
      ],
      "address": "9wtGmqMamnKfz49XBwnJASbjcVnnKnT78qKopCL54TAk",
      "chain_type": "solana",
      "created_at": 1744300912644,
      "policy_ids": [
        "string"
      ],
      "owner_id": "lzjb3xnjk2ntod3w1hgwa358",
      "public_key": "public_key"
    }
  ]
}