---
title: "Changes to Create an Onboarding Form"
method: POST
path: "/onboarding_forms"
---

# Changes to Create an Onboarding Form

`POST /onboarding_forms`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 27 revisions.

- **2026-09-24** `27f92cb842a4`: 1 breaking, 4 info
- **2026-09-19** `b86139232ef9`: 5 info
- **2026-09-15** `f815c4ab8822`: 3 breaking, 12 info
- **2026-09-12** `fa256b901d16`: 1 breaking, 4 warning, 1 info
- **2026-08-25** `9db82db717c5`: 1 breaking
- **2026-08-22** `7919e33b4853`: 6 breaking, 2 info
- **2026-08-08** `5426f6f99c52`: 2 breaking

## Changes

- **2026-09-24** `27f92cb842a4`: 1 breaking, 4 info
  - the response property `onboarding_link_details/expiration_in_minutes` became optional for the status `201`
  - the request property `anyOf[subschema #1: Onboarding Form - USA - Minimal Fields]/allOf[#/components/schemas/createOnboardingForm]/onboarding_link_details/expiration_in_minutes` became optional
  - the request property `anyOf[subschema #2: Onboarding Form - USA - All Fields]/allOf[#/components/schemas/createOnboardingForm]/onboarding_link_details/expiration_in_minutes` became optional
  - the request property `anyOf[subschema #3: Onboarding Form - CAN - Minimal Fields]/allOf[#/components/schemas/createOnboardingForm]/onboarding_link_details/expiration_in_minutes` became optional
  - the request property `anyOf[subschema #4: Onboarding Form - CAN - All Fields]/allOf[#/components/schemas/createOnboardingForm]/onboarding_link_details/expiration_in_minutes` became optional
- **2026-09-19** `b86139232ef9`: 5 info
  - the request optional property `anyOf[subschema #1: Onboarding Form - USA - Minimal Fields]/allOf[#/components/schemas/createOnboardingForm]/onboarding_data/associated_files` became read-only
  - the request optional property `anyOf[subschema #2: Onboarding Form - USA - All Fields]/allOf[#/components/schemas/createOnboardingForm]/onboarding_data/associated_files` became read-only
  - the request optional property `anyOf[subschema #3: Onboarding Form - CAN - Minimal Fields]/allOf[#/components/schemas/createOnboardingForm]/onboarding_data/associated_files` became read-only
  - the request optional property `anyOf[subschema #4: Onboarding Form - CAN - All Fields]/allOf[#/components/schemas/createOnboardingForm]/onboarding_data/associated_files` became read-only
  - the response optional property `onboarding_data/associated_files` became read-only for the status `201`
- **2026-09-15** `f815c4ab8822`: 3 breaking, 12 info
  - response property `onboarding_data/associated_entities/items/annual_card_volume` list-of-types was widened by adding types `string` to media type `application/json` of response `201`
  - response property `onboarding_data/entity/annual_card_volume` list-of-types was widened by adding types `integer` to media type `application/json` of response `201`
  - response property `onboarding_data/entity/principal_percentage_ownership` list-of-types was widened by adding types `integer` to media type `application/json` of response `201`
  - request property `anyOf[subschema #1: Onboarding Form - USA - Minimal Fields]/allOf[#/components/schemas/createOnboardingForm]/onboarding_data/associated_entities/items/annual_card_volume` list-of-types was widened by adding types `string` to media type `application/json`
  - request property `anyOf[subschema #1: Onboarding Form - USA - Minimal Fields]/allOf[#/components/schemas/createOnboardingForm]/onboarding_data/entity/annual_card_volume` list-of-types was widened by adding types `integer` to media type `application/json`
  - request property `anyOf[subschema #1: Onboarding Form - USA - Minimal Fields]/allOf[#/components/schemas/createOnboardingForm]/onboarding_data/entity/principal_percentage_ownership` list-of-types was widened by adding types `integer` to media type `application/json`
  - request property `anyOf[subschema #2: Onboarding Form - USA - All Fields]/allOf[#/components/schemas/createOnboardingForm]/onboarding_data/associated_entities/items/annual_card_volume` list-of-types was widened by adding types `string` to media type `application/json`
  - request property `anyOf[subschema #2: Onboarding Form - USA - All Fields]/allOf[#/components/schemas/createOnboardingForm]/onboarding_data/entity/annual_card_volume` list-of-types was widened by adding types `integer` to media type `application/json`
  - request property `anyOf[subschema #2: Onboarding Form - USA - All Fields]/allOf[#/components/schemas/createOnboardingForm]/onboarding_data/entity/principal_percentage_ownership` list-of-types was widened by adding types `integer` to media type `application/json`
  - request property `anyOf[subschema #3: Onboarding Form - CAN - Minimal Fields]/allOf[#/components/schemas/createOnboardingForm]/onboarding_data/associated_entities/items/annual_card_volume` list-of-types was widened by adding types `string` to media type `application/json`
  - request property `anyOf[subschema #3: Onboarding Form - CAN - Minimal Fields]/allOf[#/components/schemas/createOnboardingForm]/onboarding_data/entity/annual_card_volume` list-of-types was widened by adding types `integer` to media type `application/json`
  - request property `anyOf[subschema #3: Onboarding Form - CAN - Minimal Fields]/allOf[#/components/schemas/createOnboardingForm]/onboarding_data/entity/principal_percentage_ownership` list-of-types was widened by adding types `integer` to media type `application/json`
  - request property `anyOf[subschema #4: Onboarding Form - CAN - All Fields]/allOf[#/components/schemas/createOnboardingForm]/onboarding_data/associated_entities/items/annual_card_volume` list-of-types was widened by adding types `string` to media type `application/json`
  - request property `anyOf[subschema #4: Onboarding Form - CAN - All Fields]/allOf[#/components/schemas/createOnboardingForm]/onboarding_data/entity/annual_card_volume` list-of-types was widened by adding types `integer` to media type `application/json`
  - request property `anyOf[subschema #4: Onboarding Form - CAN - All Fields]/allOf[#/components/schemas/createOnboardingForm]/onboarding_data/entity/principal_percentage_ownership` list-of-types was widened by adding types `integer` to media type `application/json`
- **2026-09-12** `fa256b901d16`: 1 breaking, 4 warning, 1 info
  - the request's body type changed from `object` to no type
  - removed the request property `merchant_processors`
  - removed the request property `onboarding_data`
  - removed the request property `onboarding_link_details`
  - removed the request property `tags`
  - added `#/components/schemas/createOnboardingFormUSAMinimal, #/components/schemas/createOnboardingFormUSAAllFields, #/components/schemas/createOnboardingFormCANMinimal, #/components/schemas/createOnboardingFormCANAllFields` to the request body `anyOf` list
- **2026-08-25** `9db82db717c5`: 1 breaking
  - the response property `identity_id` became nullable for the status `201`
- **2026-08-22** `7919e33b4853`: 6 breaking, 2 info
  - the `onboarding_data/entity/annual_card_volume` request property type changed from `integer` to `string`
  - the `onboarding_data/entity/principal_percentage_ownership` request property type changed from `integer` to `string`
  - the response property `onboarding_data/additional_underwriting_data/credit_check_timestamp` became nullable for the status `201`
  - the response property `onboarding_data/additional_underwriting_data/credit_check_user_agent` became nullable for the status `201`
  - the `onboarding_data/entity/annual_card_volume` response's property type changed from `integer` to `string` for status `201`
  - the `onboarding_data/entity/principal_percentage_ownership` response's property type changed from `integer` to `string` for status `201`
  - the request property `onboarding_data/additional_underwriting_data/credit_check_timestamp` became nullable
  - the request property `onboarding_data/additional_underwriting_data/credit_check_user_agent` became nullable
- **2026-08-08** `5426f6f99c52`: 2 breaking
  - the `onboarding_data/associated_entities/items/default_statement_descriptor` request property's maxLength was decreased to `20`
  - the `onboarding_data/entity/default_statement_descriptor` request property's maxLength was decreased to `20`

---

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