Associated Persons
Create Associated Person
Attach a UBO, director, control person, partner, or authorized signer to a business account
POST
Associated persons are the UBOs, directors, control persons, partners where applicable, and authorized signers attached to a business account as part of KYB. They can be supplied inline when creating the account, or managed afterwards through the endpoints below. Authorized signatory status is represented by
is_signer=true. Creates and updates recompute the account’s onboarding requirements and are blocked once the account’s kyc_status is terminal (approved / rejected).
This endpoint attaches a UBO, director, control person, partner, or authorized signer to the account and recomputes onboarding requirements.
Unlike account creation, this endpoint does not take an
Idempotency-Key header.Path Parameters
string
required
Id of the Platform customer (e.g.
cus_…).string
required
Id of the parent account (e.g.
acct_…).Request Body
enum
required
One of
ultimate_beneficial_owner, director, control_person.boolean
Whether this person is an authorized signer for the entity and eligible to sign agreements via Submit Agreement Actions. Defaults to
false.string
required
Given name. Max 100 characters.
string | null
Middle name, if any. Max 100 characters.
string
required
Family name. Max 100 characters.
email
required
Contact email address of the person.
string | null
Contact phone number.
date
required
Date of birth, ISO 8601 (
YYYY-MM-DD).string
required
Country of residence, ISO 3166-1 alpha-2 (2 letters, e.g.
DE).string
required
Nationality, ISO 3166-1 alpha-2 (2 letters).
decimal | null
Conditional. Ownership stake with at most 5 digits and 2 decimal places. The API does not enforce a 0–100 range. Required when creating a person whose
role is ultimate_beneficial_owner; optional otherwise.Address
required
Residential address of the person.
array
Identity document data for the person (type, number, issuing country). Document images are submitted by the person inside their Verification Session, not through this API. Defaults to
[].Response
Returns200 with the new resource’s id. Use Get Associated Person to retrieve the full object.
string
Id of the newly created associated person (e.g.
aap_…).