---
title: "Update significant persons."
method: PUT
path: "/Leads/{leadId}/significantpersons"
tags: ["Create an Application"]
---

# Update significant persons.

`PUT /Leads/{leadId}/significantpersons`

## Request

- Base URL: `https://partners.staging-youlendapi.com/onboarding`
- URL: `https://partners.staging-youlendapi.com/onboarding/Leads/{leadId}/significantpersons`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://youlend-stag.eu.auth0.com/oauth/token`

## Path parameters

- `leadId` string, uuid, required

## Headers

- `api-version` string

## Request body

- SignificantPersonsModel: Collection of significant persons.
  - `significantPersons` SignificantPersonModel[], nullable: Gets or sets a list of significant persons.
    - `firstName` string, required: Gets or sets significant person's first name.
    - `surname` string, required: Gets or sets significant person's surname.
    - `typeOfPerson` 'Director' | 'BeneficialOwner' | 'DirectorAndBeneficialOwner' | 'ExecutiveOfficer' | 'ExecutiveOfficerAndOwner' | 'Owner', required: Gets or sets the type of significant person (Director and Beneficial Owner for UK & Europe, Executive Officer and Owner for the USA).
    - `address` AddressModel, required: Address Data Model.
      - `line1` string, required: Gets or sets Address Line 1.
      - `line2` string, nullable: Gets or sets Address Line 2.
      - `line3` string, nullable: Gets or sets Address Line 3.
      - `city` string, required: Gets or sets the City.
      - `region` string, nullable: Gets or sets the Region.
      - `areaCode` string, required: Gets or sets the Area Code.
      - `country` string, nullable: Gets or sets the Country. Cannot be null or empty if YL.Web.Api.ThirdParty.Onboarding.Models.AddressModel.CountryISOCode is not set. If both are set, we use YL.Web.Api.ThirdParty.Onboarding.Models.AddressModel.Country.
      - `countryISOCode` 'GBR' | 'IRL' | 'NLD' | 'BEL' | 'POL' | 'USA' | 'DEU' | 'FRA' | 'ESP' | 'DNK': Gets or sets the CountryISOCode. Cannot be null or empty if YL.Web.Api.ThirdParty.Onboarding.Models.AddressModel.Country is not set. If both are set, we use YL.Web.Api.ThirdParty.Onboarding.Models.AddressModel.Country.
    - `dateOfBirth` DateModel, required: Date Model.
      - `year` integer, required: Gets or sets Year.
      - `month` integer, required: Gets or sets Month.
      - `day` integer: Gets or sets Day.
    - `emailAddress` string, email, required: Gets or sets significant person's email address.
    - `mobilePhoneNumber` string, required: Gets or sets significant person's mobile phone number (international format, example +447586312453).
    - `percentageOwned` number, double: Gets or sets the percentage of ownership the significant person has.
    - `nationality` string, nullable: Gets or sets significant person's nationality.
    - `niNumber` string, nullable: Gets or sets significant person's NI number.
    - `socialSecurityNumber` string, nullable: Gets or sets the social security number (required for owners in the USA).
    - `placeOfBirth` string, nullable: Gets or sets significant person's place of birth.

## Response `200`

OK

- SaveSignificantPersonsResultModel: The result of creating a third party lead.
  - `leadId` string, uuid: Gets or sets the Lead Id.
  - `significantPersonIds` string[], nullable: Gets or sets the Significant person ids.

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/youlend/apis/onboarding.md) - [All operations](https://skmtc.dev/youlend/apis/onboarding/llms.txt) - [OpenAPI document](https://skmtc.dev/youlend/apis/onboarding/revisions/32aa9c8d752a?raw)