{"title":"Manage account holders","category":"default","creationDate":1679993280,"content":"

Account holders are the main API resource that represent users of your platform integration. It contains the legal entities and balance accounts of the user. The object also contains information about the user's capabilities<\/a>. To manage account holders, use the Configuration API<\/a>.<\/p>\n

This page contains instructions for common account holder operations. These operations are part of a larger process which includes verification<\/a> and onboarding steps<\/a>.<\/p>\n

\n

Account holders cannot be deleted. You can temporarily suspend them<\/a> to disable payout capabilities, or close them permanently<\/a>.<\/p>\n<\/div>\n

Create an account holder<\/h2>\n

You can create account holders using the Configuration API. To create an account holder, you need to create a legal entity<\/a> first.<\/p>\n

    \n
  1. \n

    Make a POST \/accountHolders<\/a> request using a legal entity ID<\/a>. For sole proprietorships, this is the individual legal entity ID of the owner.<\/p>\n

    \n<\/code-sample>\n<\/div>\n<\/li>\n
  2. \n

    In the response, note the unique id<\/code> of the new accountHolder<\/code> resource as well as a capabilities object with the default capabilities<\/a>. Save the response because you need it to:<\/p>\n