---
title: "Add external wallets to a user"
method: POST
path: "/v2/users/{userId}/wallets/external"
tags: ["Wallet"]
---

# Add external wallets to a user

`POST /v2/users/{userId}/wallets/external`

Add external wallets to a user

## Path parameters

- `userId` string, required

## Request body

- AddExternalWallets
  - `address` string, required — The wallet address to add
  - `chain` 'POLYGON' | 'SOLANA' | 'ETHEREUM' | 'BASE', required — The blockchain network for this wallet
  - `name` string, required — Name for the wallet
  - `referenceId` string, required — A custom reference ID for the wallet

## Response `200`

Success

- ExternalWalletObject
  - `id` string, uuid
  - `userId` string, uuid
  - `chain` 'POLYGON' | 'SOLANA' | 'ETHEREUM' | 'BASE'
  - `name` string
  - `address` string
  - `referenceId` string
  - `active` boolean
  - `createdAt` string, date-time
  - `updatedAt` string, date-time, nullable

## Other responses

- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/hifibridge/apis/hifi-api.md) · [All operations](https://skmtc.net/hifibridge/apis/hifi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hifibridge/hifi-api/revisions/74d9e530fbea/schema)