> ## Documentation Index > Fetch the complete documentation index at: https://crossmint-devin-1787949784-wallet-docs-two-concept-model.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # 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` ## OpenAPI ````yaml put /2025-06-09/users/{userLocator}/linked-wallets/{address} openapi: 3.0.0 info: contact: email: support@crossmint.com name: Crossmint Support url: https://www.crossmint.com description: Crossmint Users API title: Crossmint Users API version: 1.0.0 servers: - description: Staging environment (testnets) url: https://staging.crossmint.com/api - description: Production environment (mainnets) url: https://www.crossmint.com/api security: [] tags: [] paths: /2025-06-09/users/{userLocator}/linked-wallets/{address}: put: tags: - Users - Linked Wallets summary: Link External Wallet to User description: >- Link an external wallet address to a user. Optionally provide a proof to verify ownership. **API scope required**: `users.create` operationId: LinkedWalletsController-linkWallet-2 parameters: - description: API key required for authentication in: header name: X-API-KEY required: true schema: type: string - description: |- A user locator can be of the format: - `email:` - `userId:` - `phoneNumber:` - `twitter:` - `x:` example: email:user@example.com in: path name: userLocator required: true schema: type: string - in: path name: address required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/LinkWalletBodyDto' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/LinkedWalletResponseDto' description: Wallet linked to user components: schemas: LinkWalletBodyDto: properties: chain: description: The blockchain of the wallet enum: - abstract - abstract-testnet - apechain - aptos - arbitrum - arbitrum-sepolia - arbitrumnova - arc-testnet - astar-zkevm - avalanche - avalanche-fuji - base - base-goerli - base-sepolia - bsc - bsc-testnet - chiliz - chiliz-spicy-testnet - coti - coti-testnet - crossmint-private-testnet-ethereum - crossmint-private-testnet-polygon - curtis - ethereum - ethereum-goerli - ethereum-sepolia - flow - flow-testnet - hedera - hedera-testnet - hypersonic-testnet - lightlink - lightlink-pegasus - mantle - mantle-sepolia - mode - mode-sepolia - optimism - optimism-goerli - optimism-sepolia - plume - plume-testnet - polygon - polygon-amoy - polygon-mumbai - rari - rari-testnet - robinhood-chain - robinhood-chain-testnet - scroll - scroll-sepolia - sei-atlantic-2-testnet - sei-pacific-1 - shape - shape-sepolia - skale-nebula - skale-nebula-testnet - solana - soneium - soneium-minato-testnet - space - space-testnet - stellar - story - story-testnet - sui - tempo - tempo-testnet - u2u-nebulas - u2u-solaris - verify-testnet - viction - viction-testnet - world-chain - world-chain-sepolia - xai - xai-sepolia-testnet - xion - zenchain-testnet - zkatana - zkyoto - zora - zora-goerli - zora-sepolia example: solana type: string proof: description: A signed message proving ownership of the wallet minLength: 1 type: string required: - chain type: object LinkedWalletResponseDto: properties: address: description: The wallet address example: '0x1234567890abcdef1234567890abcdef12345678' type: string chain: description: The blockchain of the wallet enum: - abstract - abstract-testnet - apechain - aptos - arbitrum - arbitrum-sepolia - arbitrumnova - arc-testnet - astar-zkevm - avalanche - avalanche-fuji - base - base-goerli - base-sepolia - bsc - bsc-testnet - chiliz - chiliz-spicy-testnet - coti - coti-testnet - crossmint-private-testnet-ethereum - crossmint-private-testnet-polygon - curtis - ethereum - ethereum-goerli - ethereum-sepolia - flow - flow-testnet - hedera - hedera-testnet - hypersonic-testnet - lightlink - lightlink-pegasus - mantle - mantle-sepolia - mode - mode-sepolia - optimism - optimism-goerli - optimism-sepolia - plume - plume-testnet - polygon - polygon-amoy - polygon-mumbai - rari - rari-testnet - robinhood-chain - robinhood-chain-testnet - scroll - scroll-sepolia - sei-atlantic-2-testnet - sei-pacific-1 - shape - shape-sepolia - skale-nebula - skale-nebula-testnet - solana - soneium - soneium-minato-testnet - space - space-testnet - stellar - story - story-testnet - sui - tempo - tempo-testnet - u2u-nebulas - u2u-solaris - verify-testnet - viction - viction-testnet - world-chain - world-chain-sepolia - xai - xai-sepolia-testnet - xion - zenchain-testnet - zkatana - zkyoto - zora - zora-goerli - zora-sepolia example: ethereum type: string ownership: description: Ownership verification status of the wallet oneOf: - description: Ownership status for a verified wallet properties: verified: description: Whether the wallet ownership has been verified enum: - true example: true type: boolean required: - verified type: object - description: Ownership status for a wallet that has not yet been verified properties: verificationChallenge: description: >- The challenge message that must be signed to verify ownership type: string verified: description: Whether the wallet ownership has been verified enum: - false example: false type: boolean required: - verificationChallenge - verified type: object type: description: The type of linked wallet enum: - external-wallet example: external-wallet type: string required: - address - chain - ownership - type type: object ````