Wallets
Add Wallet
Link an additional wallet to a customer record
POST
/
customers
/
api
/
manage
/
{customerId}
/
wallets
curl -X POST "https://api.trusset.org/customers/api/manage/cmt0k3b9x0004cghxw7r2d5ya/wallets" \
-H "X-API-Key: trusset_your_key_here" \
-H "Content-Type: application/json" \
-d '{"walletAddress": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52", "label": "Custody account"}'
const response = await fetch(
'https://api.trusset.org/customers/api/manage/cmt0k3b9x0004cghxw7r2d5ya/wallets',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'trusset_your_key_here'
},
body: JSON.stringify({
walletAddress: '0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52',
label: 'Custody account'
})
}
);
const { data: link } = await response.json();
{
"success": true,
"data": {
"id": "cmt1f6h2k0009cghx4r8s2v6b",
"address": "0x1234f9a07C6B53d81e2A4F70C9b385d6014a7E52",
"label": "Custody account",
"isPrimary": false,
"addedAt": "2026-09-01T11:30:00.000Z",
"addedBy": "cmrz3a8q10000cghxf5w2n9k4"
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-09-01T11:30:00.000Z"
}
}
Attaches another wallet to a customer. A wallet can belong to one customer per instance, so linking one that is already in use is refused rather than moved.
Returns
201 on success.
Path Parameters
string
required
Customer record ID.
Body Parameters
string
required
The wallet to link. Stored checksummed.
string
A label for the wallet, for your own reference. Trimmed and cut to 80 characters. A value that is not a string is dropped.
Response Fields
object
Linking a wallet is a record-keeping act. It does not verify the wallet on the identity registry, and a linked wallet holds no claims of its own until it is verified. Use Verify Identity for that. Verify Identity records the wallet it verifies as the primary of a customer record, and it does not look at links. Verifying a linked wallet therefore creates a second record for it. Promote the wallet first with Promote Wallet to keep one record.
curl -X POST "https://api.trusset.org/customers/api/manage/cmt0k3b9x0004cghxw7r2d5ya/wallets" \
-H "X-API-Key: trusset_your_key_here" \
-H "Content-Type: application/json" \
-d '{"walletAddress": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52", "label": "Custody account"}'
const response = await fetch(
'https://api.trusset.org/customers/api/manage/cmt0k3b9x0004cghxw7r2d5ya/wallets',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'trusset_your_key_here'
},
body: JSON.stringify({
walletAddress: '0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52',
label: 'Custody account'
})
}
);
const { data: link } = await response.json();
{
"success": true,
"data": {
"id": "cmt1f6h2k0009cghx4r8s2v6b",
"address": "0x1234f9a07C6B53d81e2A4F70C9b385d6014a7E52",
"label": "Custody account",
"isPrimary": false,
"addedAt": "2026-09-01T11:30:00.000Z",
"addedBy": "cmrz3a8q10000cghxf5w2n9k4"
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-09-01T11:30:00.000Z"
}
}
Error Codes
| Code | HTTP | Cause |
|---|---|---|
INVALID_ADDRESS | 400 | walletAddress is missing or malformed |
NOT_FOUND | 404 | No such customer on your instance, or the record is archived |
ALREADY_PRIMARY | 409 | The wallet is already this customer’s primary |
WALLET_ALREADY_LINKED | 409 | The wallet is already linked to this customer |
WALLET_IN_USE | 409 | The wallet is another active customer’s primary, or is linked to another customer, archived ones included |
ADD_FAILED | 500 | The link could not be written |
⌘I
curl -X POST "https://api.trusset.org/customers/api/manage/cmt0k3b9x0004cghxw7r2d5ya/wallets" \
-H "X-API-Key: trusset_your_key_here" \
-H "Content-Type: application/json" \
-d '{"walletAddress": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52", "label": "Custody account"}'
const response = await fetch(
'https://api.trusset.org/customers/api/manage/cmt0k3b9x0004cghxw7r2d5ya/wallets',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'trusset_your_key_here'
},
body: JSON.stringify({
walletAddress: '0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52',
label: 'Custody account'
})
}
);
const { data: link } = await response.json();
{
"success": true,
"data": {
"id": "cmt1f6h2k0009cghx4r8s2v6b",
"address": "0x1234f9a07C6B53d81e2A4F70C9b385d6014a7E52",
"label": "Custody account",
"isPrimary": false,
"addedAt": "2026-09-01T11:30:00.000Z",
"addedBy": "cmrz3a8q10000cghxf5w2n9k4"
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-09-01T11:30:00.000Z"
}
}