v1

latestOpenAPI 3.0.0Proprietary2026-07-1313647393.0 KB

Linked Accounts

Partner Stakeholders

Create a Stakeholder

Add a business owner or director to a Linked Account. Only one stakeholder is allowed per Route Linked Account. PAN 4th character must be 'P' (individual PAN).

post/v2/accounts/{account_id}/stakeholders

Path parameters

account_idstring required

Unique identifier of the linked merchant account (e.g. acc_00000000000001).

Request body

namestring required

emailstring required

percentage_ownershipnumber

phoneobject

addressesobject

notesNotes

Key-value pairs for storing custom metadata. Maximum 15 pairs. Each key and value must not exceed 256 characters.

Response

Stakeholder created.

idstring

Stakeholder ID. Prefix: sth_

entity'stakeholder'

namestring

Full name of the stakeholder.

emailstring

Email address.

percentage_ownershipnumber

Ownership percentage (0-100).

notesNotes

Key-value pairs for storing custom metadata. Maximum 15 pairs. Each key and value must not exceed 256 characters.

created_atinteger