---
title: "Changes to Create an Identity"
method: POST
path: "/identities"
---

# Changes to Create an Identity

`POST /identities`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 27 revisions.

- **2026-09-12** `fa256b901d16`: 1 info
- **2026-08-22** `7919e33b4853`: 2 breaking, 14 info
- **2026-08-08** `5426f6f99c52`: 2 breaking

## Changes

- **2026-09-12** `fa256b901d16`: 1 info
  - added `#/components/schemas/createIdentitySenderAndRecipientPersonal, #/components/schemas/createIdentitySenderAndRecipientBusiness` to the request body `oneOf` list
- **2026-08-22** `7919e33b4853`: 2 breaking, 14 info
  - the response property `entity/personal_address` became nullable for the status `201`
  - the `entity/personal_address` response's property type changed from no type to `object` for status `201`
  - added the new optional request property `oneOf[subschema #2: Seller (CAN)]/entity/ach_max_transaction_amount`
  - the request property `oneOf[subschema #2: Seller (CAN)]/entity/business_address/line2` became nullable
  - added the optional property `additional_underwriting_data/annual_card_volume` to the response with the `201` status
  - added the optional property `entity/business_tax_id_fingerprint` to the response with the `201` status
  - added the optional property `entity/business_tax_id_provided` to the response with the `201` status
  - added the optional property `entity/personal_address/line2` to the response with the `201` status
  - added the optional property `entity/tax_id_fingerprint` to the response with the `201` status
  - added the optional property `entity/tax_id_provided` to the response with the `201` status
  - removed `#/components/schemas/address` from the `entity/personal_address` response property `allOf` list for the response status `201`
  - added the required property `entity/personal_address/city` to the response with the `201` status
  - added the required property `entity/personal_address/country` to the response with the `201` status
  - added the required property `entity/personal_address/line1` to the response with the `201` status
  - added the required property `entity/personal_address/postal_code` to the response with the `201` status
  - added the required property `entity/personal_address/region` to the response with the `201` status
- **2026-08-08** `5426f6f99c52`: 2 breaking
  - the `oneOf[subschema #1: Seller (USA)]/entity/default_statement_descriptor` request property's maxLength was decreased to `20`
  - the `oneOf[subschema #2: Seller (CAN)]/entity/default_statement_descriptor` request property's maxLength was decreased to `20`

---

[Operation](https://skmtc.dev/finix/apis/finix-api-reference/docs/identities/post.md) - [API](https://skmtc.dev/finix/apis/finix-api-reference.md) - [Page](https://skmtc.dev/finix/apis/finix-api-reference/changes/identities/post)