---
title: "Changes to Create a person"
method: POST
path: "/persons"
---

# Changes to Create a person

`POST /persons`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 24 revisions.

- **2026-10-29** `6a63920239d8`: 22 breaking, 3 warning, 5 info
- **2026-10-06** `aa43bab6253c`: 1 breaking
- **2026-09-01** `0def92bc65f5`: 3 info
- **2026-07-13** `03da9bc8e86b`: 1 info

## Changes

- **2026-10-29** `6a63920239d8`: 22 breaking, 3 warning, 5 info
  - request property `person_type` was restricted to a list of enum values
  - the `claims/items/anyOf[subschema #10: InvestmentExperienceClaimSpec]/claim_type` request property type changed from no type to `string`
  - the `claims/items/anyOf[subschema #11: RegistrationClaimSpec]/claim_type` request property type changed from no type to `string`
  - the `claims/items/anyOf[subschema #12: ContactDetailsClaimSpec]/claim_type` request property type changed from no type to `string`
  - the `claims/items/anyOf[subschema #13: LeiClaimSpec]/claim_type` request property type changed from no type to `string`
  - the `claims/items/anyOf[subschema #14: RegisteredAddressClaimSpec]/claim_type` request property type changed from no type to `string`
  - the `claims/items/anyOf[subschema #15: OperatingAddressClaimSpec]/claim_type` request property type changed from no type to `string`
  - the `claims/items/anyOf[subschema #16: BusinessNatureClaimSpec]/claim_type` request property type changed from no type to `string`
  - the `claims/items/anyOf[subschema #17: ExpectedActivityClaimSpec]/claim_type` request property type changed from no type to `string`
  - the `claims/items/anyOf[subschema #18: RelationshipsClaimSpec]/claim_type` request property type changed from no type to `string`
  - the `claims/items/anyOf[subschema #1: IdentityClaimSpec]/claim_type` request property type changed from no type to `string`
  - the `claims/items/anyOf[subschema #2: NationalitiesClaimSpec]/claim_type` request property type changed from no type to `string`
  - the `claims/items/anyOf[subschema #3: ResidenceClaimSpec]/claim_type` request property type changed from no type to `string`
  - the `claims/items/anyOf[subschema #4: TaxResidenciesClaimSpec]/claim_type` request property type changed from no type to `string`
  - the `claims/items/anyOf[subschema #5: FatcaStatusClaimSpec]/claim_type` request property type changed from no type to `string`
  - the `claims/items/anyOf[subschema #6: PepStatusClaimSpec]/claim_type` request property type changed from no type to `string`
  - the `claims/items/anyOf[subschema #7: EducationLevelClaimSpec]/claim_type` request property type changed from no type to `string`
  - the `claims/items/anyOf[subschema #8: EmploymentClaimSpec]/claim_type` request property type changed from no type to `string`
  - the `claims/items/anyOf[subschema #9: FinancialProfileClaimSpec]/claim_type` request property type changed from no type to `string`
  - the `person_type` request property type changed from no type to `string`
  - added `#/components/schemas/IdentityPersonClaimSummary, #/components/schemas/NationalitiesPersonClaimSummary, #/components/schemas/ResidencePersonClaimSummary, #/components/schemas/TaxResidenciesPersonClaimSummary, #/components/schemas/FatcaStatusPersonClaimSummary, #/components/schemas/PepStatusPersonClaimSummary, #/components/schemas/EducationLevelPersonClaimSummary, #/components/schemas/EmploymentPersonClaimSummary, #/components/schemas/FinancialProfilePersonClaimSummary, #/components/schemas/InvestmentExperiencePersonClaimSummary, #/components/schemas/RegistrationPersonClaimSummary, #/components/schemas/ContactDetailsPersonClaimSummary, #/components/schemas/LeiPersonClaimSummary, #/components/schemas/RegisteredAddressPersonClaimSummary, #/components/schemas/OperatingAddressPersonClaimSummary, #/components/schemas/BusinessNaturePersonClaimSummary, #/components/schemas/ExpectedActivityPersonClaimSummary, #/components/schemas/RelationshipsPersonClaimSummary` to the `claims/items/` response property `oneOf` list for the response status `201`
  - the `person_type` response's property type changed from no type to `string` for status `201`
  - removed `#/components/schemas/PersonType` from the `person_type` request property `allOf` list
  - added the new `legal` enum value to the `person_type` response property for the response status `201`
  - added the new `natural` enum value to the `person_type` response property for the response status `201`
  - added the new `legal` enum value to the request property `person_type`
  - added the new `natural` enum value to the request property `person_type`
  - removed `#/components/schemas/PersonType` from the `person_type` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/IdentityPersonClaimSummary, #/components/schemas/NationalitiesPersonClaimSummary, #/components/schemas/ResidencePersonClaimSummary, #/components/schemas/TaxResidenciesPersonClaimSummary, #/components/schemas/FatcaStatusPersonClaimSummary, #/components/schemas/PepStatusPersonClaimSummary, #/components/schemas/EducationLevelPersonClaimSummary, #/components/schemas/EmploymentPersonClaimSummary, #/components/schemas/FinancialProfilePersonClaimSummary, #/components/schemas/InvestmentExperiencePersonClaimSummary, #/components/schemas/RegistrationPersonClaimSummary, #/components/schemas/ContactDetailsPersonClaimSummary, #/components/schemas/LeiPersonClaimSummary, #/components/schemas/RegisteredAddressPersonClaimSummary, #/components/schemas/OperatingAddressPersonClaimSummary, #/components/schemas/BusinessNaturePersonClaimSummary, #/components/schemas/ExpectedActivityPersonClaimSummary, #/components/schemas/RelationshipsPersonClaimSummary` from the `claims/items/` response property `anyOf` list for the response status `201`
  - added discriminator to `claims/items/` response property for the response status `201`
- **2026-10-06** `aa43bab6253c`: 1 breaking
  - response property `context/additionalProperties/` list-of-types was widened by adding types `array` to media type `application/json` of response `400`
- **2026-09-01** `0def92bc65f5`: 3 info
  - added `#/components/schemas/IdentityPersonClaimSummary, #/components/schemas/NationalitiesPersonClaimSummary, #/components/schemas/ResidencePersonClaimSummary, #/components/schemas/TaxResidenciesPersonClaimSummary, #/components/schemas/FatcaStatusPersonClaimSummary, #/components/schemas/PepStatusPersonClaimSummary, #/components/schemas/EducationLevelPersonClaimSummary, #/components/schemas/EmploymentPersonClaimSummary, #/components/schemas/FinancialProfilePersonClaimSummary, #/components/schemas/InvestmentExperiencePersonClaimSummary, #/components/schemas/RegistrationPersonClaimSummary, #/components/schemas/ContactDetailsPersonClaimSummary, #/components/schemas/LeiPersonClaimSummary, #/components/schemas/RegisteredAddressPersonClaimSummary, #/components/schemas/OperatingAddressPersonClaimSummary, #/components/schemas/BusinessNaturePersonClaimSummary, #/components/schemas/ExpectedActivityPersonClaimSummary, #/components/schemas/RelationshipsPersonClaimSummary` to the `claims/items/` response property `anyOf` list for the response status `201`
  - removed discriminator from `claims/items/` response property for the response status `201`
  - removed `#/components/schemas/IdentityPersonClaimSummary, #/components/schemas/NationalitiesPersonClaimSummary, #/components/schemas/ResidencePersonClaimSummary, #/components/schemas/TaxResidenciesPersonClaimSummary, #/components/schemas/FatcaStatusPersonClaimSummary, #/components/schemas/PepStatusPersonClaimSummary, #/components/schemas/EducationLevelPersonClaimSummary, #/components/schemas/EmploymentPersonClaimSummary, #/components/schemas/FinancialProfilePersonClaimSummary, #/components/schemas/InvestmentExperiencePersonClaimSummary, #/components/schemas/RegistrationPersonClaimSummary, #/components/schemas/ContactDetailsPersonClaimSummary, #/components/schemas/LeiPersonClaimSummary, #/components/schemas/RegisteredAddressPersonClaimSummary, #/components/schemas/OperatingAddressPersonClaimSummary, #/components/schemas/BusinessNaturePersonClaimSummary, #/components/schemas/ExpectedActivityPersonClaimSummary, #/components/schemas/RelationshipsPersonClaimSummary` from the `claims/items/` response property `oneOf` list for the response status `201`
- **2026-07-13** `03da9bc8e86b`: 1 info
  - api tag `customers` added

---

[Operation](https://skmtc.dev/joinsophic/apis/sophic-engine-api/docs/persons/post.md) - [API](https://skmtc.dev/joinsophic/apis/sophic-engine-api.md) - [Page](https://skmtc.dev/joinsophic/apis/sophic-engine-api/changes/persons/post)