Add Wallets to a Business Account

Business Accounts are in early access. See the overview for the model.

There are two ways to give a business account a wallet:

Create a fresh wallet owned by the account from the start.
Link an existing embedded wallet you already own, so the team can share it.

Either way, the account owns the wallet (not a single user), and you become its first signer.

Create a fresh wallet

createWalletForBusinessAccount creates a new embedded wallet owned by the account.

JavaScript

import { createWalletForBusinessAccount } from '@dynamic-labs-sdk/client/waas';

const wallet = await createWalletForBusinessAccount({
  businessAccountId: account.id,
  chain: 'EVM',
});

string

required

The account that will own the wallet.

Chain

required

The chain to create the wallet on (e.g. EVM, SOL).

string

Optional passphrase used to encrypt the caller’s key share.

ThresholdSignatureScheme

Optional signing scheme; defaults to the environment’s configuration.

Link an existing wallet

addWalletToBusinessAccount links a wallet you already own into the account. It returns the updated account, including members, signers, and wallets.

JavaScript
React

import { addWalletToBusinessAccount } from '@dynamic-labs-sdk/client/waas';

const detail = await addWalletToBusinessAccount({
  walletId,
  businessAccountId: account.id,
});

import { useAddWalletToBusinessAccount } from '@dynamic-labs-sdk/react-hooks';

const LinkWallet = ({ walletId, businessAccountId }) => {
  const { mutate, isPending } = useAddWalletToBusinessAccount();
  return (
    <button onClick={() => mutate({ walletId, businessAccountId })} disabled={isPending}>
      Link wallet
    </button>
  );
};

businessAccountId is optional when linking. If omitted, the wallet is linked into its per-wallet business account (found or created automatically). Pass it explicitly to link into a specific account you own or administer.

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.

Next steps

Manage signers

Add teammates or agents as signers on the wallet.

Sign transactions

Sign with a business-account wallet.

Last modified on August 5, 2026

⌘I

Installation & Configuration

Chains & Networks

Authenticate

User & Session Management

Business Accounts

Wallets

Flow

Swaps

Funding & Onramp

Events

Building UI

Migrating from React

Extension Development

Add Wallets to a Business Account

Create a fresh wallet

Link an existing wallet

Next steps

Manage signers

Sign transactions

​Create a fresh wallet

​Link an existing wallet

​Next steps

Manage signers

Sign transactions

Create a fresh wallet

Link an existing wallet

Next steps