Embedded wallets

Create wallets with recovery

Changed on

Create one or more wallets associated with a recovery user, so the user can later regain wallet access via the linked accounts. Deprecated; prefer the standard wallet creation flow combined with a separate recovery setup.

post/v1/wallets_with_recovery

Request

  • Base URL
    https://api.privy.io
  • URL
    https://api.privy.io/v1/wallets_with_recovery
  • Auth
    HTTP basic

Headers

privy-app-idstring required

ID of your Privy app.

Request body

Example request

{
  "wallets": [
    {
      "chain_type": "ethereum",
      "policy_ids": []
    },
    {
      "chain_type": "solana",
      "policy_ids": []
    }
  ],
  "primary_signer": {
    "subject_id": "cm7oxq1el000e11o8iwp7d0d0"
  },
  "recovery_user": {
    "linked_accounts": [
      {
        "type": "email",
        "address": "john@doe.com"
      }
    ]
  }
}

Response

Object with user and wallet data.

recovery_user_idstring required

The ID of the created user.

Example response

{
  "wallets": [
    {
      "id": "id2tptkqrxd39qo9j423etij",
      "address": "0xF1DBff66C993EE895C8cb176c30b07A559d76496",
      "display_name": "Treasury",
      "external_id": "my-order-123",
      "chain_type": "ethereum",
      "policy_ids": [],
      "additional_signers": [],
      "owner_id": "rkiz0ivz254drv1xw982v3jq",
      "parent_wallet_id": null,
      "entity": {
        "id": "jorpjo4rfxj62nx1itt8y1zt",
        "type": "user"
      },
      "created_at": 1741834854578,
      "exported_at": null,
      "imported_at": null,
      "archived_at": null
    }
  ]
}

Changes

    • warning

      added the new xrpl enum value to the // response property for the response status

    • info

      added the new optional request property //

    • info

      added the new xrpl enum value to the request property //

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      the // response's property pattern ^[a-zA-Z0-9_-]+$ was added for the status

    • info

      added the optional property // to the response with the status