---
title: "Changes to Create account holder"
method: POST
path: "/v1/account_holders"
---

# Changes to Create account holder

`POST /v1/account_holders`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 94 revisions.

- **2026-10-16** `f7ded6c181ab`: 1 info
- **2026-08-27** `8e304f78f67e`: 7 breaking, 10 info
- **2026-08-21** `79d607871de9`: 1 breaking, 3 info
- **2026-08-19** `3d21138daf4c`: 1 breaking, 13 info
- **2026-07-27** `1d6de495a31d`: 2 breaking, 3 info
- **2026-07-24** `e2a23b7a5f9f`: 1 info

## Changes

- **2026-10-16** `f7ded6c181ab`: 1 info
  - endpoint added
- **2026-08-27** `8e304f78f67e`: 7 breaking, 10 info
  - removed `#/components/schemas/V1UsResidentialAddress, #/components/schemas/V1NonUsResidentialAddress` from the `beneficiary_data/anyOf[#/components/schemas/V1BusinessBeneficiaryData -> subschema #3: Business]/beneficial_owners/items/anyOf[#/components/schemas/V1NonUsBeneficiaryData -> subschema #2: Non-US individual]/residential_address` request property `anyOf` list
  - removed `#/components/schemas/V1UsResidentialAddress, #/components/schemas/V1NonUsResidentialAddress` from the `beneficiary_data/anyOf[#/components/schemas/V1BusinessBeneficiaryData -> subschema #3: Business]/beneficial_owners/items/anyOf[#/components/schemas/V1UsBeneficiaryData -> subschema #1: US individual]/residential_address` request property `anyOf` list
  - removed `#/components/schemas/V1UsResidentialAddress, #/components/schemas/V1NonUsResidentialAddress` from the `beneficiary_data/anyOf[#/components/schemas/V1BusinessBeneficiaryData -> subschema #3: Business]/physical_address` request property `anyOf` list
  - removed `#/components/schemas/V1UsResidentialAddress, #/components/schemas/V1NonUsResidentialAddress` from the `beneficiary_data/anyOf[#/components/schemas/V1BusinessBeneficiaryData -> subschema #3: Business]/registered_address` request property `anyOf` list
  - removed `#/components/schemas/V1UsResidentialAddress, #/components/schemas/V1NonUsResidentialAddress` from the `beneficiary_data/anyOf[#/components/schemas/V1NonUsBeneficiaryData -> subschema #2: Non-US individual]/residential_address` request property `anyOf` list
  - removed `#/components/schemas/V1UsResidentialAddress, #/components/schemas/V1NonUsResidentialAddress` from the `beneficiary_data/anyOf[#/components/schemas/V1UsBeneficiaryData -> subschema #1: US individual]/residential_address` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `beneficiary_data/anyOf[#/components/schemas/V1BusinessBeneficiaryData -> subschema #3: Business]/control_person` request property `anyOf` list
  - added `#/components/schemas/V1UsResidentialAddressRequest, #/components/schemas/V1NonUsResidentialAddressRequest` to the `beneficiary_data/anyOf[#/components/schemas/V1BusinessBeneficiaryData -> subschema #3: Business]/beneficial_owners/items/anyOf[#/components/schemas/V1NonUsBeneficiaryData -> subschema #2: Non-US individual]/residential_address` request property `anyOf` list
  - added `#/components/schemas/V1UsResidentialAddressRequest, #/components/schemas/V1NonUsResidentialAddressRequest` to the `beneficiary_data/anyOf[#/components/schemas/V1BusinessBeneficiaryData -> subschema #3: Business]/beneficial_owners/items/anyOf[#/components/schemas/V1UsBeneficiaryData -> subschema #1: US individual]/residential_address` request property `anyOf` list
  - added `#/components/schemas/V1UsResidentialAddressRequest, #/components/schemas/V1NonUsResidentialAddressRequest` to the `beneficiary_data/anyOf[#/components/schemas/V1BusinessBeneficiaryData -> subschema #3: Business]/physical_address` request property `anyOf` list
  - added `#/components/schemas/V1UsResidentialAddressRequest, #/components/schemas/V1NonUsResidentialAddressRequest` to the `beneficiary_data/anyOf[#/components/schemas/V1BusinessBeneficiaryData -> subschema #3: Business]/registered_address` request property `anyOf` list
  - added `#/components/schemas/V1UsResidentialAddressRequest, #/components/schemas/V1NonUsResidentialAddressRequest` to the `beneficiary_data/anyOf[#/components/schemas/V1NonUsBeneficiaryData -> subschema #2: Non-US individual]/residential_address` request property `anyOf` list
  - added `#/components/schemas/V1UsResidentialAddressRequest, #/components/schemas/V1NonUsResidentialAddressRequest` to the `beneficiary_data/anyOf[#/components/schemas/V1UsBeneficiaryData -> subschema #1: US individual]/residential_address` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `beneficiary_data/anyOf[#/components/schemas/V1BusinessBeneficiaryData -> subschema #3: Business]/control_person` request property `anyOf` list
  - the request property `beneficiary_data/anyOf[#/components/schemas/V1BusinessBeneficiaryData -> subschema #3: Business]/doing_business_as` became optional
  - added `subschema #1, subschema #2` to the `beneficiary_data/anyOf[#/components/schemas/V1BusinessBeneficiaryDataResponse -> subschema #3: Business]/control_person` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `beneficiary_data/anyOf[#/components/schemas/V1BusinessBeneficiaryDataResponse -> subschema #3: Business]/control_person` response property `anyOf` list for the response status `200`
- **2026-08-21** `79d607871de9`: 1 breaking, 3 info
  - removed `#/components/schemas/UsBeneficiaryData, #/components/schemas/NonUsBeneficiaryData, #/components/schemas/BusinessBeneficiaryData` from the `beneficiary_data` request property `anyOf` list
  - added `#/components/schemas/V1UsBeneficiaryData, #/components/schemas/V1NonUsBeneficiaryData, #/components/schemas/V1BusinessBeneficiaryData` to the `beneficiary_data` request property `anyOf` list
  - added `#/components/schemas/V1UsBeneficiaryDataResponse, #/components/schemas/V1NonUsBeneficiaryDataResponse, #/components/schemas/V1BusinessBeneficiaryDataResponse` to the `beneficiary_data` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/UsBeneficiaryDataResponse, #/components/schemas/NonUsBeneficiaryDataResponse, #/components/schemas/BusinessBeneficiaryDataResponse` from the `beneficiary_data` response property `anyOf` list for the response status `200`
- **2026-08-19** `3d21138daf4c`: 1 breaking, 13 info
  - removed `subschema #1, subschema #2` from the `beneficiary_data/anyOf[#/components/schemas/BusinessBeneficiaryData]/control_person` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `beneficiary_data/anyOf[#/components/schemas/BusinessBeneficiaryData]/control_person` request property `anyOf` list
  - removed the pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` from the request property `beneficiary_data/anyOf[#/components/schemas/BusinessBeneficiaryData]/beneficial_owners/items/anyOf[#/components/schemas/NonUsBeneficiaryData]/date_of_birth`
  - removed the pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` from the request property `beneficiary_data/anyOf[#/components/schemas/BusinessBeneficiaryData]/beneficial_owners/items/anyOf[#/components/schemas/UsBeneficiaryData]/date_of_birth`
  - removed the pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` from the request property `beneficiary_data/anyOf[#/components/schemas/NonUsBeneficiaryData]/date_of_birth`
  - removed the pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` from the request property `beneficiary_data/anyOf[#/components/schemas/UsBeneficiaryData]/date_of_birth`
  - removed the pattern `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$` from the request property `account_program_id`
  - added `subschema #1, subschema #2` to the `beneficiary_data/anyOf[#/components/schemas/BusinessBeneficiaryDataResponse]/control_person` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `beneficiary_data/anyOf[#/components/schemas/BusinessBeneficiaryDataResponse]/control_person` response property `anyOf` list for the response status `200`
  - the `beneficiary_data/anyOf[#/components/schemas/BusinessBeneficiaryDataResponse]/beneficial_owners/items/anyOf[#/components/schemas/NonUsBeneficiaryDataResponse]/date_of_birth` response's property pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` was removed for the status `200`
  - the `beneficiary_data/anyOf[#/components/schemas/BusinessBeneficiaryDataResponse]/beneficial_owners/items/anyOf[#/components/schemas/UsBeneficiaryDataResponse]/date_of_birth` response's property pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` was removed for the status `200`
  - the `beneficiary_data/anyOf[#/components/schemas/NonUsBeneficiaryDataResponse]/date_of_birth` response's property pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` was removed for the status `200`
  - the `beneficiary_data/anyOf[#/components/schemas/UsBeneficiaryDataResponse]/date_of_birth` response's property pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` was removed for the status `200`
  - the `created_at` response's property pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$` was removed for the status `200`
- **2026-07-27** `1d6de495a31d`: 2 breaking, 3 info
  - added the new required request property `holder_type`
  - the `header` request parameter `Idempotency-Key` became required
  - added `#/components/schemas/BusinessBeneficiaryData` to the `beneficiary_data` request property `anyOf` list
  - added `#/components/schemas/BusinessBeneficiaryDataResponse` to the `beneficiary_data` response property `anyOf` list for the response status `200`
  - added the required property `holder_type` to the response with the `200` status
- **2026-07-24** `e2a23b7a5f9f`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/augustus/apis/ivy-api/docs/v1/account_holders/post.md) - [API](https://skmtc.dev/augustus/apis/ivy-api.md) - [Page](https://skmtc.dev/augustus/apis/ivy-api/changes/v1/account_holders/post)