> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trusset.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Wallet

> Link an additional wallet to a customer record

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

<ParamField path="customerId" type="string" required>Customer record ID.</ParamField>

## Body Parameters

<ParamField body="walletAddress" type="string" required>The wallet to link. Stored checksummed.</ParamField>

<ParamField body="label" type="string">A label for the wallet, for your own reference.</ParamField>

## Response Fields

<ResponseField name="data" type="object">
  <Expandable>
    <ResponseField name="id" type="string">The link record ID. Use it to recognise the row on [List Wallets](/endpoints/customers/list-wallets).</ResponseField>
    <ResponseField name="walletAddress" type="string">The linked wallet.</ResponseField>
    <ResponseField name="label" type="string">The label, or `null`.</ResponseField>
    <ResponseField name="addedAt" type="string">ISO 8601.</ResponseField>
    <ResponseField name="addedBy" type="string">The issuer that linked it.</ResponseField>
  </Expandable>
</ResponseField>

<Note>
  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](/endpoints/customers/verify-identity) for that.
</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.trusset.org/customers/api/manage/cus_abc123/wallets" \
    -H "X-API-Key: trusset_your_key_here" \
    -H "Content-Type: application/json" \
    -d '{"walletAddress": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52", "label": "Custody account"}'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "id": "clw_7f2a",
      "walletAddress": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52",
      "label": "Custody account",
      "addedAt": "2026-09-06T11:30:00.000Z",
      "addedBy": "iss_xyz789"
    }
  }
  ```
</ResponseExample>

## 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 belongs to another customer on this instance      |
| `ADD_FAILED`            | `500` | The link could not be written                                |