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

# Add Wallets to a Business Account

> Link an existing embedded wallet to a business account in Unity, and remove it again.

> [!NOTE]
>
> Business Accounts are in **early access**. See [Business Accounts](https://www.dynamic.xyz/docs/business-accounts/accounts.md) for the model.

The Unity SDK links an embedded wallet you already own into a business account, so the team can share it. The account then owns the wallet (not a single user), and you become its first [signer](https://www.dynamic.xyz/docs/unity/business-accounts/manage-signers.md).

## Find the wallet ID

Linking takes a wallet ID. Read it from the user's wallets, which are created automatically after authentication (see [wallet creation](https://www.dynamic.xyz/docs/unity/wallet-creation.md)).

```csharp theme={"system"}
using System.Linq;

var wallet = DynamicSDK.Instance.Wallets.UserWallets.FirstOrDefault();
if (wallet == null) return;

var walletId = wallet.Id;
```

## Link a wallet

`AddWallet` links the wallet into the account, and returns the updated `BusinessAccountDetail` including members, signers, and wallets.

```csharp theme={"system"}
var detail = await DynamicSDK.Instance.BusinessAccounts.AddWallet(
    account.Id, walletId);

Debug.Log(detail.Wallets?.Count ?? 0);
```

**walletId** `string` *required*

The wallet to link, from `DynamicSDK.Instance.Wallets.UserWallets`.

**businessAccountId** `string`

The account to link into. Call the single-argument `AddWallet(walletId)` overload to omit it, which links the wallet into its per-wallet business account, found or created automatically. Pass it explicitly to link into a specific account you own or administer.

> [!WARNING]
>
> Only the wallet's owner can link it, and a wallet can belong to **one** business account. Linking a wallet that already belongs to a different account is rejected.

## Remove a wallet

`RemoveWallet` unlinks a wallet from the account and returns the updated account.

```csharp theme={"system"}
var detail = await DynamicSDK.Instance.BusinessAccounts.RemoveWallet(
    account.Id, walletId);
```

## On error

Both calls throw on failure. Catch the error and show it to the player, for example when the caller is not an owner or admin of the account:

```csharp theme={"system"}
try
{
    await DynamicSDK.Instance.BusinessAccounts.AddWallet(account.Id, walletId);
}
catch (System.Exception e)
{
    Debug.LogError($"Failed to link wallet: {e.Message}");
}
```

## Next steps

> [card] [Manage signers](https://www.dynamic.xyz/docs/unity/business-accounts/manage-signers.md)
>
> Add teammates or servers as signers on the wallet.

> [card] [Sign transactions](https://www.dynamic.xyz/docs/unity/business-accounts/signing.md)
>
> Sign with a business-account wallet.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.