---
title: "Link beneficiary to company (KYB 1.0)"
method: POST
path: "/resources/applicants/{applicantId}/info/companyInfo/beneficiaries"
---

# Link beneficiary to company (KYB 1.0)

`POST /resources/applicants/{applicantId}/info/companyInfo/beneficiaries`

## Request

- Base URL: `https://api.sumsub.com`
- URL: `https://api.sumsub.com/resources/applicants/{applicantId}/info/companyInfo/beneficiaries`
- Auth: API key in header `X-App-Token`
- TypeScript: <https://skmtc.dev/sumsub/apis/sumsub-api/docs/resources/applicants/:applicantId/info/companyInfo/beneficiaries/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `applicantId` string, required

## Request body

- object
  - `applicant` object, required: Includes the identifier (`id`) of the applicant that needs to be linked as a beneficiary to the company profile.
    - `id` string, required: Applicant identifier (`applicantId`) of the beneficiary to be added.
  - `applicantId` string, required: Applicant identifier of the beneficiary to be linked to the company profile.
  - `positions` string[]: <p>Positions in the company that the beneficiary is holding.<p><ul><li><code>director</code> — appointed to manage the company business and affairs.</li><li><code>shareholder</code> — owns shares in the company stock.</li><li><code>other</code> — specify a position that does not meet the two above.</li></ul><p>Add one position per string.<p>
  - `type` 'ubo' | 'shareholder' | 'representative' | 'director', required: Beneficiary single role in the company control and ownership structure.<br><br>Possible values:<ul><li><code>ubo</code> — ultimate beneficial owner of the company.</li><li><code>shareholder</code> — owns shares in the company stock.</li><li><code>representative</code> — authorized to act or speak for or in support of the company.</li><li><code>director</code> — appointed to manage the company business and affairs.</li></ul>

## Changes

- **2026-11-03** `fcc702e558a2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sumsub/apis/sumsub-api/changes/resources/applicants/:applicantId/info/companyInfo/beneficiaries/post.md)

---

[API](https://skmtc.dev/sumsub/apis/sumsub-api.md) - [All operations](https://skmtc.dev/sumsub/apis/sumsub-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sumsub/apis/sumsub-api/revisions/fcc702e558a2?raw)