Wallets
Create Wallet
Creates a new wallet of specified type. If called with an idempotency key or for a user who already has a wallet, returns existing wallet. Supports both custodial and non-custodial wallet types.
API scope required: wallets.create
POST
/
v1-alpha2
/
wallets
This is an alpha API and subject to change.
Headers
X-API-KEY
string
requiredAPI key required for authentication
x-idempotency-key
string
Unique key to prevent duplicate wallet creation
Body
application/json
EVM smart wallet creation input
type
enum<string>
requiredAvailable options:
evm-smart-wallet
config
object
linkedUser
string
An optional parameter to link the wallet to a crossmint user in format 'prefix:value' (e.g. email:user@example.com)
Response
201 - application/json
type
enum<string>
requiredThe type of wallet configuration
Available options:
evm-smart-wallet
, solana-custodial-wallet
address
string
requiredThe onchain address of the wallet
linkedUser
string
The user that is linked to this wallet in format <locatorType>:<value>
createdAt
number
ISO timestamp of when the wallet was created
config
Wallet type specific configuration settings