Associated persons
Create associated person
Create a new associated person for a business user.
POST
This endpoint is currently available in Sandbox only. It is not yet available in Production.
id you use to complete their processes.
Types
type is the only required field, and it determines what the person represents:
beneficial-owner: An individual who ultimately owns or controls a share of the business. AcceptsownershipPercentage.authorized-signer: An individual authorized to act on behalf of the business. Does not acceptownershipPercentage.beneficial-owner-and-authorized-signer: An individual who is both. AcceptsownershipPercentage.
The type cannot be changed after creation. To correct it, delete the person and create them again.
Progressive creation
Every field other thantype is optional at creation, so you can register a person as soon as you know their role and fill in the rest later through Update associated person profile.Authorizations
OAuth 2.0 authentication.
Body
application/json
- Beneficial owner
- Authorized signer
- Beneficial owner and authorized signer
Allowed value:
"beneficial-owner"The full legal name.
Maximum string length:
200Pattern:
^\S+\s+\S+(\s+\S+)*$The person's role in the business (e.g., CFO, CEO).
Required string length:
1 - 140Pattern:
^\S.*\S$|^\S$The person's address of residency.
The date of birth.
The place of birth.
The legal identifiers.
Maximum array length:
20The ownership percentage for this beneficial owner.
Required range:
x <= 100Response
Associated person created successfully.