POST
/
2022-06-09
/
wallets
Create Wallet
curl --request POST \
  --url https://staging.crossmint.com/api/2022-06-09/wallets \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '{
  "type": "evm-smart-wallet",
  "config": {
    "adminSigner": {
      "type": "evm-keypair",
      "address": "0x1234567890123456789012345678901234567890"
    }
  },
  "linkedUser": "email:user@example.com"
}'
{
  "type": "evm-smart-wallet",
  "linkedUser": "email:user@example.com",
  "address": "0x1234567890123456789012345678901234567890",
  "config": {
    "adminSigner": {
      "type": "evm-keypair",
      "address": "0x1234567890123456789012345678901234567890",
      "locator": "evm-keypair:0x1234567890123456789012345678901234567890"
    }
  }
}

Headers

​
X-API-KEY
string
required

API key required for authentication

​
x-idempotency-key
string

Unique key to prevent duplicate wallet creation

Body

application/json

EVM smart wallet creation input

Response

201
application/json

Returns an existing wallet (200) if one already exists for the provided linkedUser or idempotencyKey, or creates and returns a new wallet (201). The response includes the wallet details and whether it was newly created.

Complete wallet configuration including type-specific settings