Skip to content
CLIUnofficial

privy wallets create

Provision a wallet and verify it; does not fund, sign or transact.

Usage

Section titled “Usage”
Terminal window
privy wallets create [options]

Options

Section titled “Options”
Option Description
--dry-run Validate and print the API request without network access or credentials.
--yes Confirm this mutation or export.
--confirm-owner <id> Explicitly confirm assigning this owner; later control changes require owner authorization.
--body <json> JSON body, or - to read stdin.
--file <path> JSON body file, or - to read stdin.
--chain-type <string> Chain type, e.g. ethereum or solana; Privy validates current chain availability.
--display-name <string> Wallet display name; JSON null clears it.
--owner-id <string> Owner user DID or key-quorum ID. Assigning an owner requires --confirm-owner with the same ID and makes future control changes require owner authorization.
--policy-ids <json> Complete attached-policy array (zero or one policy); [] detaches the current policy.
--additional-signers <json> Complete signer array: {signer_id, override_policy_ids:[]}. Replaces all existing additional signers.
--entity <object> Organization binding {type:“organization”,id:“…”}. Can be assigned once; cannot subsequently be changed.
--allow-production Explicitly allow this production mutation; also requires --yes.

Global options such as --app, --account and --profile also apply. See the command reference overview.

Examples

Section titled “Examples”
Terminal window
privy wallets create --chain-type ethereum --display-name Treasury --dry-run
privy wallets create --chain-type ethereum --display-name Treasury --yes

Behavior

Section titled “Behavior”
  • Changes data: yes. Preview with --dry-run, then run with --yes and any required confirmations.
  • Scope: app
  • Before it runs: Read app environment, wallet and referenced resources. Control changes on owned wallets require approval. New owner assignment requires --confirm-owner.
  • Production apps: Requires --allow-production and --yes.
  • Verification: Fresh exact-ID wallet lookup and comparison; exports are job submissions.
  • Retries: None.
  • Caution: Changing owners/policies/signers changes control of funds, but does not execute a transaction.
Section titled “Related guides”

Inspect the full contract locally with privy schema wallets create.

Privy CLI is an unofficial, community project by Samarth Saxena. Not affiliated with or endorsed by Privy. The Privy name and wordmark belong to Privy. It uses undocumented dashboard APIs that can change.