> ## 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.

# Promote Wallet

> Make a linked wallet the customer primary

Makes a linked wallet the customer's primary. The wallet that was primary becomes a linked wallet, so nothing is lost in the swap.

## Path Parameters

<ParamField path="customerId" type="string" required>Customer record ID.</ParamField>
<ParamField path="address" type="string" required>The linked wallet to promote. It must already be linked to this customer.</ParamField>

## Response Fields

<ResponseField name="data" type="object">
  The customer record after the swap, with the promoted wallet as `walletAddress`.
</ResponseField>

<Warning>
  The primary wallet is what other parts of the platform read as the customer's address. Promoting changes which wallet that is, and it does not move anything on chain. Identity verification and claims stay attached to the wallet that holds them, so a newly promoted wallet is unverified until it is verified in its own right.
</Warning>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.trusset.org/customers/api/manage/cus_abc123/wallets/0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52/promote" \
    -H "X-API-Key: trusset_your_key_here"
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "id": "cus_abc123",
      "walletAddress": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52",
      "email": "alice@example.com",
      "country": "DEU",
      "updatedAt": "2026-09-06T11:45:00.000Z"
    }
  }
  ```
</ResponseExample>

## Error Codes

| Code              | HTTP  | Cause                                                                       |
| ----------------- | ----- | --------------------------------------------------------------------------- |
| `INVALID_ADDRESS` | `400` | `address` is not a valid address                                            |
| `NOT_FOUND`       | `404` | No such customer, or that wallet is not linked to them                      |
| `ALREADY_PRIMARY` | `409` | The wallet is already the primary                                           |
| `WALLET_IN_USE`   | `409` | The wallet, or the outgoing primary, conflicts with another customer record |
| `PROMOTE_FAILED`  | `500` | The promotion could not be written                                          |