# Creates A Key Party Folder Linked To The Profile Id

Uses the details provided by the user to create key parties. Returns the created key parties information.

Endpoint: POST /compliance/kyc-protect/profiles/{profileId}/keyparties
Version: 1.10.9
Security: bearerToken

## Path parameters:

  - `profileId` (string, required)
    id of the profile

## Request fields (application/json):

  - `items` (array)

  - `items.name` (string,null)
    Name of the key party Maximum length is 200 characters

  - `items.firstName` (string,null)
    First name of the key party  Valid for entity type Individual  Maximum length is 200 characters combining First name, Middle name and Last name

  - `items.middleName` (string,null)
    Middle name of the key party  Valid for entity type Individual  Maximum length is 200 characters combining First name, Middle name and Last name

  - `items.lastName` (string,null)
    Last name of the key party  Valid for entity type Individual  Maximum length is 200 characters combining First name, Middle name and Last name

  - `items.entityType` (string,null)
    Entity type of the key party  Types - individual, business

  - `items.keyPartyType` (string,null)
    Entity type of the key party Types - director, shareHolder, ubo

  - `items.gender` (string,null)
    Gender of the key party Valid for entity type Individual
    Enum: "male", "female"

  - `items.dateOfBirth` (string,null)
    Date of birth of the key party Date YYYY-MM-DD or YYYY format. Must be after 1900 and not in the future Valid for the entity type Individual

  - `items.organisationNumber` (string,null)
    Key party organisation number  Valid for entity type Business

  - `items.activityCode` (string,null)
    Activity code of the key party  Valid for entity type Business

  - `items.percentageOfShares` (number,null)
    Share percentage of the key party  Valid for key party type ShareHolder

  - `items.role` (string,null)
    Role of the key party  Valid for key party type Director

  - `items.countryCode` (string,null)
    Country code of the key party

  - `items.address` (object)

  - `items.address.buildingDetails` (string,null)
    The building details of the address being created. Must have a maximum length of 250 characters

  - `items.address.street` (string,null)
    The street of the address being created. Must have a maximum length of 250 characters

  - `items.address.city` (string,null)
    The city of the address being created. Must have a maximum length of 250 characters

  - `items.address.region` (string,null)
    The region of the address being created. Must have a maximum length of 250 characters

  - `items.address.postalCode` (string,null)
    The postal code of the address being created Must have a maximum length of 50 characters

  - `items.address.countryCode` (string,null)
    Two-letter ISO-3166-2 country code

  - `items.address.type` (string,null, required)
    Type of the address, registered, trading, other

  - `items.address.description` (string,null)
    The description of the address being created Must have a maximum length of 250 characters

## Response 201 fields (application/json):

  - `failed` (array)

  - `failed.failedItem` (object)

  - `failed.failedItem.name` (string,null)
    Name of the key party
Maximum length is 200 characters

  - `failed.failedItem.firstName` (string,null)
    First name of the key party
 Valid for only entity type Individual  Maximum length is 200 characters combining First name, Middle name and Last name

  - `failed.failedItem.middleName` (string,null)
    Middle name of the key party
 Valid for only entity type Individual  Maximum length is 200 characters combining First name, Middle name and Last name

  - `failed.failedItem.lastName` (string,null)
    Last name of the key party
 Valid for only entity type Individual  Maximum length is 200 characters combining First name, Middle name and Last name

  - `failed.failedItem.entityType` (string,null)
    Entity type of the key party, individual, business

  - `failed.failedItem.keyPartyType` (string,null)
    Type of the key party
 Valid Key Party types for entity type Individual are Director, Ubo and ShareHolder  Valid Key Party types for entity type Business are Ubo and ShareHolder , director, shareHolder, ubo

  - `failed.failedItem.gender` (string,null)
    Gender of the key party
Valid for entity type Individual, male, female

  - `failed.failedItem.dateOfBirth` (string,null)
    Date of birth of the key party
Date YYYY-MM-DD or YYYY format. Must be after 1900 and not in the future
 Valid for the entity type Individual

  - `failed.failedItem.organisationNumber` (string,null)
    Key party organisation number 
 Valid for entity type Business

  - `failed.failedItem.activityCode` (string,null)
    Activity code of the key party
 Valid for entity type Business

  - `failed.failedItem.percentageOfShares` (number,null)
    Share percentage of the key party
 Valid for key party type ShareHolder

  - `failed.failedItem.role` (string,null)
    Role of the key party
 Valid for key party type Director

  - `failed.failedItem.countryCode` (string,null)
    Country code of the key party

  - `failed.failedItem.address` (object)

  - `failed.failedItem.address.buildingDetails` (string,null)
    The building details of the address being created.
Must have a maximum length of 250 characters

  - `failed.failedItem.address.street` (string,null)
    The street of the address being created.
Must have a maximum length of 250 characters

  - `failed.failedItem.address.city` (string,null)
    The city of the address being created.
Must have a maximum length of 250 characters

  - `failed.failedItem.address.region` (string,null)
    The region of the address being created.
Must have a maximum length of 250 characters

  - `failed.failedItem.address.postalCode` (string,null)
    The postal code of the address being created
Must have a maximum length of 50 characters

  - `failed.failedItem.address.countryCode` (string,null)
    Two-letter ISO-3166-2 country code

  - `failed.failedItem.address.type` (string,null)
    Type of address, registered,trading, other

  - `failed.failedItem.address.description` (string,null)
    The description of the address being created
Must have a maximum length of 250 characters

  - `failed.error` (object)

  - `failed.error.type` (string)

  - `failed.error.title` (string)

  - `failed.error.status` (number)

  - `failed.error.detail` (string)

  - `failed.error.instance` (string)

  - `failed.error.additionalProp1` (string)

  - `failed.error.additionalProp2` (string)

  - `failed.error.additionalProp3` (string)

  - `successful` (array)

  - `successful.id` (string)
    Id of the key party

  - `successful.name` (string)
    Name of the key party

  - `successful.firstName` (string)
    First name of the key party

  - `successful.middleName` (string,null)
    Middle name of the key party

  - `successful.lastName` (string)
    Last name of the key party

  - `successful.keyPartyType` (string)
    Type of the key party, director,shareHolder,ubo

  - `successful.gender` (string,null)
    Gender of the key party, male, female

  - `successful.dateOfBirth` (string,null)
    Date of birth of the key party

  - `successful.organisationNumber` (string,null)
    Key party organization number

  - `successful.activityCode` (string,null)
    Activity code of the key party

  - `successful.percentageOfShares` (number,null)
    Share percentage of the key party

  - `successful.role` (string,null)
    Role of the key party

  - `successful.searchId` (string,null)
    Search Id of the key party

  - `successful.createdAt` (string)
    Key party created time

  - `successful.createdById` (integer)
    Id of the user who created the key party

  - `successful.createdBy` (string)
    Name of the user who created the key party

  - `successful.modifiedAt` (string,null)
    key party last updated time

  - `successful.modifiedById` (string,null)
    Id of the user who last modified the key party

  - `successful.modifiedBy` (string,null)
    Name of the user who last modified the key party

## Response 400 fields (application/json):

  - `correlationId` (string)
    A unique ID assigned to this request.

  - `message` (string)

  - `details` (string)
    Provides further information on why the request was rejected

## Response 401 fields (application/json):

  - `error` (string)

## Response 403 fields (application/json):

  - `message` (string)
    Example: "Access forbidden"

## Response 404 fields (application/json):

  - `correlationId` (string)
    A unique ID assigned to this request.

  - `message` (string)

  - `details` (string)
    Provides further information on why the request was rejected

## Response 409 fields (application/json):

  - `correlationId` (string)
    The unique identifier. (A UUID specified by RFC4122).

  - `message` (string)

  - `details` (string)
    Provides further information on why the request was rejected