Members & Roles

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

Members control who can administer the account. That is separate from who can sign. There are three roles:

Role	Can do
`owner`	Everything, including transferring ownership. Exactly one per account.
`admin`	Add/remove members and signers, link wallets.
`viewer`	Read-only access.

Adding someone as a member does not let them sign, and adding a signer does not grant admin rights. Grant each explicitly. Member and role operations require step-up authentication.

Add a member

addBusinessAccountMember adds a member as admin or viewer (defaults to viewer). Identify them with a targetIdentity: a known userId, or an identifier + identifierType (the user is created if absent).

JavaScript
React

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

await addBusinessAccountMember({
  businessAccountId: account.id,
  targetIdentity: { identifier: 'admin@acme.com', identifierType: 'email' },
  role: 'admin',
});

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

const { mutate } = useAddBusinessAccountMember();
mutate({ businessAccountId, targetIdentity: { userId: 'user-123' }, role: 'viewer' });

Change a member’s role

updateBusinessAccountMemberRole moves a member between admin and viewer. (Use ownership transfer, below, to change who the owner is.)

JavaScript
React

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

await updateBusinessAccountMemberRole({
  businessAccountId: account.id,
  userId,
  role: 'admin',
});

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

const { mutate } = useUpdateBusinessAccountMemberRole();
mutate({ businessAccountId, userId, role: 'viewer' });

Remove a member

JavaScript
React

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

await removeBusinessAccountMember({ businessAccountId: account.id, userId });

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

const { mutate } = useRemoveBusinessAccountMember();
mutate({ businessAccountId, userId });

Removing a member also tears down any signer rows they held on the account’s wallets — they lose signing access too, not just admin rights.

Transfer ownership

transferBusinessAccountOwnership promotes an existing member to owner and atomically demotes the current owner to admin. Owner-only.

JavaScript
React

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

await transferBusinessAccountOwnership({
  businessAccountId: account.id,
  newOwnerUserId,
});

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

const { mutate } = useTransferBusinessAccountOwnership();
mutate({ businessAccountId, newOwnerUserId });

Transferring ownership revokes the caller’s session server-side (their scope changed from owner to admin), so the current owner is signed out and must re-authenticate to pick up their new role. The new owner must already be a member.

Installation & Configuration

Chains & Networks

Authenticate

User & Session Management

Business Accounts

Wallets

Flow

Swaps

Funding & Onramp

Events

Building UI

Migrating from React

Extension Development

Members & Roles

Add a member

Change a member’s role

Remove a member

Transfer ownership

​Add a member

​Change a member’s role

​Remove a member

​Transfer ownership

Add a member

Change a member’s role

Remove a member

Transfer ownership