Link External Wallet to User

Link an external wallet address to a user. Optionally provide a proof to verify ownership.

API scope required: users.create

PUT /2025-06-09/users/{userLocator}/linked-wallets/{address}

Link External Wallet to User

cURL

curl --request PUT \
  --url https://staging.crossmint.com/api/2025-06-09/users/{userLocator}/linked-wallets/{address} \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '
{
  "chain": "solana",
  "proof": "<string>"
}
'

200

{
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "type": "external-wallet",
  "ownership": {
    "verified": false,
    "verificationChallenge": "<string>"
  },
  "chain": "ethereum"
}

Headers

X-API-KEY · string · required

API key required for authentication

Path Parameters

userLocator · string · required

address · string · required

Body

application/json

Request body for linking an external wallet to a user

chain · enum<string> · required

The blockchain of the wallet

Available options: ethereum, polygon, arbitrum, base, solana, stellar, ethereum-sepolia, polygon-amoy, arbitrum-sepolia, base-sepolia

Example:

"solana"

proof · string

A signed message proving ownership of the wallet

Minimum string length: 1

Response

200 - application/json

Wallet linked to user

Response for a linked external wallet

address · string · required

The wallet address

Example:

"0x1234567890abcdef1234567890abcdef12345678"

type · enum<string> · required

The type of linked wallet

Available options: external-wallet

Example:

"external-wallet"

ownership · object · required

Ownership verification status of the wallet

Option 1

Option 2

Show child attributes

chain · enum<string> · required

The blockchain of the wallet

Available options: ethereum, polygon, arbitrum, base, solana, stellar, ethereum-sepolia, polygon-amoy, arbitrum-sepolia, base-sepolia

Example:

"ethereum"