Add a beneficial owner
Adds a beneficial owner (UBO) to a company-owned account.
Authorizations
JWT bearer token. Include as Authorization: Bearer <token>. See the Authentication guide for how to obtain one.
Headers
API version. Omit to use the default version.
"1"
Unique key to ensure idempotent request processing. Required on all POST, PUT, and PATCH requests.
Path Parameters
UUID of the account.
Body
Request body for adding a beneficial owner.
Full legal name of the beneficial owner.
"João Silva"
Identification document of an owner or beneficial owner. Tax-id documents (for example CNPJ, CPF) are validated against the type-specific format rules, and their type implies the country, so country is omitted for them. Non-fiscal documents (PASSPORT) carry an explicit country.
Contact phone number with country code.
"5511999999999"
Contact email address.
"joao.silva@example.com"
Percentage of ownership.
50
Whether this beneficial owner is the legal representative of the account. Defaults to false.
false
Response
Beneficial owner added.
"b2c3d4e5-f6a7-8901-bcde-f12345678901"
"João Silva"
Identification document of an owner or beneficial owner. Tax-id documents (for example CNPJ, CPF) are validated against the type-specific format rules, and their type implies the country, so country is omitted for them. Non-fiscal documents (PASSPORT) carry an explicit country.
"5511999999999"
"joao.silva@example.com"
false
A point-in-time state of a beneficial owner.
50