Skip to main content
Creating an organization takes two steps. First, designate a default key quorum to administer the organization’s wallets. Then, create the organization object itself.

Create default key quorum

The default key quorum should be a highly-privileged, locked-down set of individuals. By default, it administers every wallet for the organization, including:
  • Executing signatures and transactions
  • Adding, removing, and modifying policies
  • Provisioning scoped access to other organization members
  • Managing private key export
Privy strongly recommends keeping the default key quorum narrow and highly trusted. To create it, create a key quorum with a user_ids array of the desired members and an authorization_threshold for required approvals. Keep the threshold above 1 to avoid a unilateral point of control over organization wallets.

Creating quorums for other roles

Your app may also create additional key quorums for the organization with fewer privileges than the default key quorum. For example, these key quorums wouldn’t be able to update a wallet’s configuration or manage private key export, but could execute signatures and transactions within their defined scope.

Create organization

With the default key quorum in place, create the organization itself. An organization is a first-class object that groups wallets under a single business. It tracks every wallet assigned to it and records which key quorum administers it. Create an organization with a display_name and the default_key_quorum_id from above: