Skip to main content
POST
/
v2
/
users
/
{userId}
/
wallets
/
external
Add external wallets to a user
curl --request POST \
  --url https://production.hifibridge.com/v2/users/{userId}/wallets/external \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "address": "<string>",
  "name": "<string>",
  "referenceId": "<string>"
}
'
{
  "address": "0xFE5ea74612ba174BaF7FC4C45f05dB7fF73aBA21",
  "chain": "POLYGON",
  "name": "my-wallet",
  "referenceId": "my-wallet-reference-id",
  "createdAt": "2025-09-24T19:03:41.107Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
userId
string
required

ID of the user

Body

application/json
​
address
string
required

The wallet address to add

​
chain
enum<string>
required

The blockchain network for this wallet

Available options:
POLYGON,
SOLANA,
ETHEREUM,
BASE,
TRON
​
name
string
required

Name for the wallet

​
referenceId
string
required

A custom reference ID for the wallet

Response

Success

​
id
string<uuid>
​
userId
string<uuid>
​
chain
enum<string>
Available options:
POLYGON,
SOLANA,
ETHEREUM,
BASE,
TRON
​
name
string
​
address
string
​
referenceId
string
​
active
boolean
​
createdAt
string<date-time>
​
updatedAt
string<date-time> | null