Business Accounts are in early access. See Business Accounts for the model.
BusinessAccountMemberRole has three values:
Adding someone as a member does not let them sign, and adding a signer does not grant admin rights. Grant each explicitly.
Who can call what
Every method acts on behalf of the signed-in user. Reads require membership, and modifications such as adding members or signers, linking wallets, and transferring ownership require the owner or admin role. A call made without the required role fails, so checkdetail.Members for the caller’s role before you show those actions in your UI.
Add a member
AddMember adds a member as Admin or Viewer (it defaults to Viewer). Identify them with a known userId, or with an identifier plus identifierType, in which case the user is created if they do not exist yet.
How to read
identifier: Email, PhoneNumber, ExternalUserId, SocialUsername, SocialAccountId, or Id.List members
Get returns the account with its members, including each member’s role.
Change a member’s role
UpdateMemberRole moves a member between Admin and Viewer. To change who the owner is, transfer ownership instead.
Remove a member
Transfer ownership
TransferOwnership promotes an existing member to owner and demotes the current owner to Admin in the same operation. Owner only.
Custom roles
A business account can also define custom roles that inheritAdmin or Viewer, such as cfo or treasurer. Custom roles are defined, assigned, and deleted by name with the JavaScript SDK; BusinessAccountMemberRole here takes only the built-in values. A member holding a custom role reports its inherited built-in role.
Next steps
Manage signers
Grant and revoke signing access per wallet.
Sign transactions
Sign with a business-account wallet.