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>",
  "chain": "POLYGON",
  "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
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
name
string
address
string
referenceId
string
active
boolean
createdAt
string<date-time>
updatedAt
string<date-time> | null
I