---
title: "Create a UBO"
method: POST
path: "/v2.01/{ClientId}/users/{UserId}/kyc/ubodeclarations/{UboDeclarationId}/ubos"
tags: ["uboDeclarations"]
---

# Create a UBO

`POST /v2.01/{ClientId}/users/{UserId}/kyc/ubodeclarations/{UboDeclarationId}/ubos`

<Warning icon="fa-regular fa-triangle-exclamation">
**Caution – Legacy endpoints being superseded by the hosted KYC/KYB solution**

Mangopay's [hosted KYC/KYB solution](/guides/users/verification/hosted) is becoming mandatory for all platforms, and allows Legal Users to declare and verify all beneficial owners in the same [IDV Session](/api-reference/idv-sessions/idv-session-object) object.

The [criteria defining beneficial owners](/guides/glossary#beneficial-owner-ubo) remain the same.
</Warning>

In Sandbox, you can set the `FirstName` of the first UBO to simulate the outcome (`Status`) of the declaration after submission:
- `AcceptUBO` for `VALIDATED`
- `RefusedUBO` for `REFUSED`
- `IncompleteUBO` for `INCOMPLETE`

[See the guide for more details](/guides/users/verification/beneficial-owners/how-to) **&rarr;**

## Path parameters

- `ClientId` string, required
- `UserId` string, required
- `UboDeclarationId` string, required

## Headers

- `Authorization` string, required

## Request body

- CreateAUBORequest
  - `LastName` string, required — Max. length: 100 characters The last name of the beneficial owner.
  - `FirstName` string, required — Max. length: 100 characters The first name of the beneficial owner.
  - `Birthday` integer, required — The date of birth of the beneficial owner. **Note:** This is a Unix timestamp in UTC. Ensure you convert your timezone to UTC to avoid midnight being interpreted as the day before.
  - `Nationality` string, required — Format: Two-letter country code ([ISO 3166-1 alpha-2 format](/api-reference/overview/data-formats)) The nationality of the beneficial owner.
  - `Address` AddressSubPropsRequired, required — The postal address.
    - `AddressLine1` string, required — The first line of the address.
    - `AddressLine2` string — The second line of the address.
    - `City` string, required — The city of the address.
    - `Region` string — Required if `Country` is US, CA, or MX. The region of the address.
    - `PostalCode` string, required — The postal code of the address. The postal code can contain the following characters: alphanumeric, dashes, and spaces.
    - `Country` string, required — Format: Two-letter country code ([ISO 3166-1 alpha-2 format](/api-reference/overview/data-formats)) The country of the address.
  - `Birthplace` CreateAuboRequestBirthplace, required — Information about the beneficial owner's place of birth.
    - `City` string, required — The city in which the beneficial owner was born.
    - `Country` string, required — Format: Two-letter country code ([ISO 3166-1 alpha-2 format](/api-reference/overview/data-formats)) The country in which the beneficial owner was born.

## Response `200`

Success

- UBOResponse
  - `Id` string — Max length: 128 characters (see [data formats](/api-reference/overview/data-formats) for details) The unique identifier of the object.
  - `CreationDate` integer — Unix timestamp (UTC) of the date and time the object was created.
  - `LastName` string — Max. length: 100 characters The last name of the beneficial owner.
  - `FirstName` string — Max. length: 100 characters The first name of the beneficial owner.
  - `Birthday` integer — The date of birth of the beneficial owner. **Note:** This is a Unix timestamp in UTC. Ensure you convert your timezone to UTC to avoid midnight being interpreted as the day before.
  - `Nationality` string — The nationality of the beneficial owner.
  - `Address` Address — The postal address.
    - `AddressLine1` string — The first line of the address.
    - `AddressLine2` string — The second line of the address.
    - `City` string — The city of the address.
    - `Region` string — Required if `Country` is US, CA, or MX. The region of the address.
    - `PostalCode` string — The postal code of the address. The postal code can contain the following characters: alphanumeric, dashes, and spaces.
    - `Country` string — Format: Two-letter country code ([ISO 3166-1 alpha-2 format](/api-reference/overview/data-formats)) The country of the address.
  - `Birthplace` UboResponseBirthplace — Information about the beneficial owner's place of birth.
    - `City` string — The city in which the beneficial owner was born.
    - `Country` string — Format: Two-letter country code ([ISO 3166-1 alpha-2 format](/api-reference/overview/data-formats)) The country in which the beneficial owner was born.
  - `IsActive` boolean — Whether or not the UBO is considered in the declaration. To disregard a UBO, this parameter must be set to `false`. This action is irreversible.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/mangopay/apis/api-reference.md) · [All operations](https://skmtc.dev/mangopay/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mangopay/api-reference/revisions/956211a94070/schema)