---
title: "Changes to Create an Authorization"
method: POST
path: "/authorizations"
---

# Changes to Create an Authorization

`POST /authorizations`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 12 of 27 revisions.

- **2026-10-28** `c62db965e7dc`: 1 info
- **2026-10-14** `8c3b82d51eff`: 1 breaking, 2 info
- **2026-10-10** `4eb2502fcc00`: 10 warning
- **2026-09-24** `27f92cb842a4`: 5 breaking, 5 warning, 3 info
- **2026-09-12** `fa256b901d16`: 1 warning, 1 info
- **2026-09-11** `c1659d0a3477`: 15 breaking, 17 info
- **2026-09-05** `1d6b546b10f2`: 2 breaking, 4 warning, 2 info
- **2026-09-02** `3ada948cf2c5`: 8 breaking, 4 info
- **2026-08-25** `9db82db717c5`: 4 info
- **2026-08-22** `7919e33b4853`: 11 breaking, 70 info
- **2026-08-21** `96653f0c196b`: 2 info
- **2026-08-08** `5426f6f99c52`: 3 breaking

## Changes

- **2026-10-28** `c62db965e7dc`: 1 info
  - added `#/components/schemas/createAuthorizationVerifyCVVAndAVS` to the request body `anyOf` list
- **2026-10-14** `8c3b82d51eff`: 1 breaking, 2 info
  - removed `#/components/schemas/createAuthorizationMinimalFields, #/components/schemas/createAuthorization, #/components/schemas/createAuthorizationCanada, #/components/schemas/createAuthorization3DSecure, #/components/schemas/createAuthorizationBuyerCharges, #/components/schemas/createAuthorizationCardPresent, #/components/schemas/createAuthorizationCVV, #/components/schemas/createAuthorizationAutoRental, #/components/schemas/createAuthorizationGaming, #/components/schemas/createAuthorizationLodging, #/components/schemas/createAuthorizationLevel2Processing, #/components/schemas/createAuthorizationLevel3Processing, #/components/schemas/createAuthorizationRecurringUnscheduled` from the request body `oneOf` list
  - added `#/components/schemas/createAuthorizationMinimalFields, #/components/schemas/createAuthorization, #/components/schemas/createAuthorizationCanada, #/components/schemas/createAuthorization3DSecure, #/components/schemas/createAuthorization3DSecureSession, #/components/schemas/createAuthorizationBuyerCharges, #/components/schemas/createAuthorizationCardPresent, #/components/schemas/createAuthorizationCVV, #/components/schemas/createAuthorizationAutoRental, #/components/schemas/createAuthorizationGaming, #/components/schemas/createAuthorizationLodging, #/components/schemas/createAuthorizationLevel2Processing, #/components/schemas/createAuthorizationLevel3Processing, #/components/schemas/createAuthorizationRecurringUnscheduled` to the request body `anyOf` list
  - added the optional property `3d_secure_session` to the response with the `201` status
- **2026-10-10** `4eb2502fcc00`: 10 warning
  - added the new `CARD_PRESENT_IOS_TAP_TO_PAY` enum value to the `created_via` response property for the response status `201`
  - added the new `CARD_PRESENT_IOS_TAP_TO_PAY_SDK` enum value to the `created_via` response property for the response status `201`
  - added the new `DEVICE_ORDER` enum value to the `created_via` response property for the response status `201`
  - added the new `PLUGIN_ADMOJI` enum value to the `created_via` response property for the response status `201`
  - added the new `PLUGIN_GR4VY` enum value to the `created_via` response property for the response status `201`
  - added the new `PLUGIN_LACORE` enum value to the `created_via` response property for the response status `201`
  - added the new `PLUGIN_PRYZR` enum value to the `created_via` response property for the response status `201`
  - added the new `PLUGIN_SERVMAN` enum value to the `created_via` response property for the response status `201`
  - added the new `PLUGIN_SOAP_PAY` enum value to the `created_via` response property for the response status `201`
  - added the new `PLUGIN_VRIO` enum value to the `created_via` response property for the response status `201`
- **2026-09-24** `27f92cb842a4`: 5 breaking, 5 warning, 3 info
  - request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #2: Authorization - All Fields]/additional_purchase_data/item_data/items/commodity_code` list-of-types was narrowed by removing types `integer` from media type `application/json`
  - request property `oneOf[subschema #11: Authorization - Level 2 Processing]/additional_purchase_data/item_data/items/commodity_code` list-of-types was narrowed by removing types `integer` from media type `application/json`
  - request property `oneOf[subschema #12: Authorization - Level 3 Processing]/additional_purchase_data/item_data/items/commodity_code` list-of-types was narrowed by removing types `integer` from media type `application/json`
  - request property `oneOf[subschema #2: Authorization - All Fields]/additional_purchase_data/item_data/items/commodity_code` list-of-types was narrowed by removing types `integer` from media type `application/json`
  - request property `oneOf[subschema #8: Authorization - Motor Vehicle Rental]/allOf[subschema #2: Authorization - All Fields]/additional_purchase_data/item_data/items/commodity_code` list-of-types was narrowed by removing types `integer` from media type `application/json`
  - the `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #2: Authorization - All Fields]/additional_purchase_data/item_data/items/commodity_code` request property's maxLength was set to `12`
  - the `oneOf[subschema #11: Authorization - Level 2 Processing]/additional_purchase_data/item_data/items/commodity_code` request property's maxLength was set to `12`
  - the `oneOf[subschema #12: Authorization - Level 3 Processing]/additional_purchase_data/item_data/items/commodity_code` request property's maxLength was set to `12`
  - the `oneOf[subschema #2: Authorization - All Fields]/additional_purchase_data/item_data/items/commodity_code` request property's maxLength was set to `12`
  - the `oneOf[subschema #8: Authorization - Motor Vehicle Rental]/allOf[subschema #2: Authorization - All Fields]/additional_purchase_data/item_data/items/commodity_code` request property's maxLength was set to `12`
  - added the new optional request property `oneOf[subschema #5: Authorization - Buyer Charges]/statement_descriptor`
  - added the new optional request property `oneOf[subschema #5: Authorization - Buyer Charges]/tags`
  - response property `additional_purchase_data/item_data/items/commodity_code` list-of-types was narrowed by removing types `integer` from media type `application/json` of response `201`
- **2026-09-12** `fa256b901d16`: 1 warning, 1 info
  - added the new `CARD_PRESENT_DEVICE_READER_SDK` enum value to the `created_via` response property for the response status `201`
  - added the optional property `credential_on_file` to the response with the `201` status
- **2026-09-11** `c1659d0a3477`: 15 breaking, 17 info
  - removed `#/components/schemas/createAuthorizationPartialAuthorization` from the request body `oneOf` list
  - the response property `additional_lodging_data/allOf[#/components/schemas/additional_lodging_data]/extra_charge_details/gift_shop_amount` became nullable for the status `201`
  - the response property `additional_lodging_data/allOf[#/components/schemas/additional_lodging_data]/extra_charge_details/laundry_amount` became nullable for the status `201`
  - the response property `additional_lodging_data/allOf[#/components/schemas/additional_lodging_data]/extra_charge_details/mini_bar_amount` became nullable for the status `201`
  - the response property `additional_lodging_data/allOf[#/components/schemas/additional_lodging_data]/extra_charge_details/other_amount` became nullable for the status `201`
  - the response property `additional_lodging_data/allOf[#/components/schemas/additional_lodging_data]/extra_charge_details/phone_amount` became nullable for the status `201`
  - the response property `additional_lodging_data/allOf[#/components/schemas/additional_lodging_data]/extra_charge_details/restaurant_amount` became nullable for the status `201`
  - the response property `additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/extra_charge_details/extra_mileage_amount` became nullable for the status `201`
  - the response property `additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/extra_charge_details/fuel_amount` became nullable for the status `201`
  - the response property `additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/extra_charge_details/insurance_amount` became nullable for the status `201`
  - the response property `additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/extra_charge_details/late_return_amount` became nullable for the status `201`
  - the response property `additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/extra_charge_details/one_way_service_fee_amount` became nullable for the status `201`
  - the response property `additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/extra_charge_details/parking_violation_amount` became nullable for the status `201`
  - response property `additional_purchase_data/item_data/items/commodity_code` list-of-types was widened by adding types `integer` to media type `application/json` of response `201`
  - the `additional_purchase_data/item_data/items/commodity_code` response property's maxLength was unset from `12` for the response status `201`
  - the request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #1]/additional_lodging_data/allOf[#/components/schemas/additional_lodging_data]/extra_charge_details/gift_shop_amount` became nullable
  - the request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #1]/additional_lodging_data/allOf[#/components/schemas/additional_lodging_data]/extra_charge_details/laundry_amount` became nullable
  - the request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #1]/additional_lodging_data/allOf[#/components/schemas/additional_lodging_data]/extra_charge_details/mini_bar_amount` became nullable
  - the request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #1]/additional_lodging_data/allOf[#/components/schemas/additional_lodging_data]/extra_charge_details/other_amount` became nullable
  - the request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #1]/additional_lodging_data/allOf[#/components/schemas/additional_lodging_data]/extra_charge_details/phone_amount` became nullable
  - the request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #1]/additional_lodging_data/allOf[#/components/schemas/additional_lodging_data]/extra_charge_details/restaurant_amount` became nullable
  - the request property `oneOf[subschema #8: Authorization - Motor Vehicle Rental]/allOf[subschema #1]/additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/extra_charge_details/extra_mileage_amount` became nullable
  - the request property `oneOf[subschema #8: Authorization - Motor Vehicle Rental]/allOf[subschema #1]/additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/extra_charge_details/fuel_amount` became nullable
  - the request property `oneOf[subschema #8: Authorization - Motor Vehicle Rental]/allOf[subschema #1]/additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/extra_charge_details/insurance_amount` became nullable
  - the request property `oneOf[subschema #8: Authorization - Motor Vehicle Rental]/allOf[subschema #1]/additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/extra_charge_details/late_return_amount` became nullable
  - the request property `oneOf[subschema #8: Authorization - Motor Vehicle Rental]/allOf[subschema #1]/additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/extra_charge_details/one_way_service_fee_amount` became nullable
  - the request property `oneOf[subschema #8: Authorization - Motor Vehicle Rental]/allOf[subschema #1]/additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/extra_charge_details/parking_violation_amount` became nullable
  - request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #2: Authorization - All Fields]/additional_purchase_data/item_data/items/commodity_code` list-of-types was widened by adding types `integer` to media type `application/json`
  - request property `oneOf[subschema #11: Authorization - Level 2 Processing]/additional_purchase_data/item_data/items/commodity_code` list-of-types was widened by adding types `integer` to media type `application/json`
  - request property `oneOf[subschema #12: Authorization - Level 3 Processing]/additional_purchase_data/item_data/items/commodity_code` list-of-types was widened by adding types `integer` to media type `application/json`
  - request property `oneOf[subschema #2: Authorization - All Fields]/additional_purchase_data/item_data/items/commodity_code` list-of-types was widened by adding types `integer` to media type `application/json`
  - request property `oneOf[subschema #8: Authorization - Motor Vehicle Rental]/allOf[subschema #2: Authorization - All Fields]/additional_purchase_data/item_data/items/commodity_code` list-of-types was widened by adding types `integer` to media type `application/json`
- **2026-09-05** `1d6b546b10f2`: 2 breaking, 4 warning, 2 info
  - the `oneOf[subschema #8: Authorization - Motor Vehicle Rental]/allOf[subschema #1]/additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/rental_rate` request property type changed from `integer` to `string`
  - the `additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/rental_rate` response's property type changed from `integer` to `string` for status `201`
  - removed the request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #2: Authorization - All Fields]/credential_on_file/initial_transfer_id`
  - removed the request property `oneOf[subschema #2: Authorization - All Fields]/credential_on_file/initial_transfer_id`
  - removed the request property `oneOf[subschema #8: Authorization - Motor Vehicle Rental]/allOf[subschema #2: Authorization - All Fields]/credential_on_file/initial_transfer_id`
  - added the new `API` enum value to the `created_via` response property for the response status `201`
  - the request property `oneOf[subschema #14: Authorization - Recurring or Unscheduled]/credential_on_file/initial_transfer_id` became optional
  - added the optional property `_links/transfer` to the response with the `201` status
- **2026-09-02** `3ada948cf2c5`: 8 breaking, 4 info
  - the request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #2: Authorization - All Fields]/receipt_options/additional_details/items/name` became required
  - the request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #2: Authorization - All Fields]/receipt_options/additional_details/items/value` became required
  - the request property `oneOf[subschema #2: Authorization - All Fields]/receipt_options/additional_details/items/name` became required
  - the request property `oneOf[subschema #2: Authorization - All Fields]/receipt_options/additional_details/items/value` became required
  - the request property `oneOf[subschema #6: Authorization - Card Present]/receipt_options/additional_details/items/name` became required
  - the request property `oneOf[subschema #6: Authorization - Card Present]/receipt_options/additional_details/items/value` became required
  - the request property `oneOf[subschema #8: Authorization - Motor Vehicle Rental]/allOf[subschema #2: Authorization - All Fields]/receipt_options/additional_details/items/name` became required
  - the request property `oneOf[subschema #8: Authorization - Motor Vehicle Rental]/allOf[subschema #2: Authorization - All Fields]/receipt_options/additional_details/items/value` became required
  - the request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #2: Authorization - All Fields]/receipt_options/additional_details` became nullable
  - the request property `oneOf[subschema #2: Authorization - All Fields]/receipt_options/additional_details` became nullable
  - the request property `oneOf[subschema #6: Authorization - Card Present]/receipt_options/additional_details` became nullable
  - the request property `oneOf[subschema #8: Authorization - Motor Vehicle Rental]/allOf[subschema #2: Authorization - All Fields]/receipt_options/additional_details` became nullable
- **2026-08-25** `9db82db717c5`: 4 info
  - added the new optional request property `oneOf[subschema #8: Authorization - Motor Vehicle Rental]/allOf[subschema #1]/additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/rental_rate`
  - added the new optional request property `oneOf[subschema #8: Authorization - Motor Vehicle Rental]/allOf[subschema #1]/additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/renter_name`
  - added the optional property `additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/rental_rate` to the response with the `201` status
  - added the optional property `additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/renter_name` to the response with the `201` status
- **2026-08-22** `7919e33b4853`: 11 breaking, 70 info
  - the response property `additional_purchase_data/customs_duty_amount` became nullable for the status `201`
  - the response property `additional_purchase_data/destination_country_code` became nullable for the status `201`
  - the response property `additional_purchase_data/destination_postal_code` became nullable for the status `201`
  - the response property `additional_purchase_data/discount_amount` became nullable for the status `201`
  - the response property `additional_purchase_data/invoice_reference_number` became nullable for the status `201`
  - the response property `additional_purchase_data/order_date` became nullable for the status `201`
  - the response property `additional_purchase_data/sales_tax` became nullable for the status `201`
  - the response property `additional_purchase_data/ship_from_postal_code` became nullable for the status `201`
  - the response property `additional_purchase_data/shipping_amount` became nullable for the status `201`
  - the response property `ip_address_details` became nullable for the status `201`
  - the `additional_purchase_data/item_data/items/quantity` response's property format changed from `decimal` to no format for status `201`
  - added the new optional request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #2: Authorization - All Fields]/additional_purchase_data/item_data/items/sales_tax_amount`
  - added the new optional request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #2: Authorization - All Fields]/additional_purchase_data/item_data/items/sales_tax_rate`
  - added the new optional request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #2: Authorization - All Fields]/receipt_options/items/items/item_details`
  - added the new optional request property `oneOf[subschema #11: Authorization - Level 2 Processing]/additional_purchase_data/item_data/items/sales_tax_amount`
  - added the new optional request property `oneOf[subschema #11: Authorization - Level 2 Processing]/additional_purchase_data/item_data/items/sales_tax_rate`
  - added the new optional request property `oneOf[subschema #12: Authorization - Level 3 Processing]/additional_purchase_data/item_data/items/sales_tax_amount`
  - added the new optional request property `oneOf[subschema #12: Authorization - Level 3 Processing]/additional_purchase_data/item_data/items/sales_tax_rate`
  - added the new optional request property `oneOf[subschema #2: Authorization - All Fields]/additional_purchase_data/item_data/items/sales_tax_amount`
  - added the new optional request property `oneOf[subschema #2: Authorization - All Fields]/additional_purchase_data/item_data/items/sales_tax_rate`
  - added the new optional request property `oneOf[subschema #2: Authorization - All Fields]/receipt_options/items/items/item_details`
  - added the new optional request property `oneOf[subschema #6: Authorization - Card Present]/receipt_options/items/items/item_details`
  - added the new optional request property `oneOf[subschema #8: Authorization - Motor Vehicle Rental]/allOf[subschema #2: Authorization - All Fields]/additional_purchase_data/item_data/items/sales_tax_amount`
  - added the new optional request property `oneOf[subschema #8: Authorization - Motor Vehicle Rental]/allOf[subschema #2: Authorization - All Fields]/additional_purchase_data/item_data/items/sales_tax_rate`
  - added the new optional request property `oneOf[subschema #8: Authorization - Motor Vehicle Rental]/allOf[subschema #2: Authorization - All Fields]/receipt_options/items/items/item_details`
  - the request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #2: Authorization - All Fields]/additional_purchase_data/customs_duty_amount` became nullable
  - the request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #2: Authorization - All Fields]/additional_purchase_data/destination_country_code` became nullable
  - the request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #2: Authorization - All Fields]/additional_purchase_data/destination_postal_code` became nullable
  - the request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #2: Authorization - All Fields]/additional_purchase_data/discount_amount` became nullable
  - the request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #2: Authorization - All Fields]/additional_purchase_data/invoice_reference_number` became nullable
  - the request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #2: Authorization - All Fields]/additional_purchase_data/order_date` became nullable
  - the request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #2: Authorization - All Fields]/additional_purchase_data/sales_tax` became nullable
  - the request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #2: Authorization - All Fields]/additional_purchase_data/ship_from_postal_code` became nullable
  - the request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #2: Authorization - All Fields]/additional_purchase_data/shipping_amount` became nullable
  - the request property `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #2: Authorization - All Fields]/receipt_options/items/items/image_details` became nullable
  - the request property `oneOf[subschema #11: Authorization - Level 2 Processing]/additional_purchase_data/customs_duty_amount` became nullable
  - the request property `oneOf[subschema #11: Authorization - Level 2 Processing]/additional_purchase_data/destination_country_code` became nullable
  - the request property `oneOf[subschema #11: Authorization - Level 2 Processing]/additional_purchase_data/destination_postal_code` became nullable
  - the request property `oneOf[subschema #11: Authorization - Level 2 Processing]/additional_purchase_data/discount_amount` became nullable
  - the request property `oneOf[subschema #11: Authorization - Level 2 Processing]/additional_purchase_data/invoice_reference_number` became nullable
  - …41 more
- **2026-08-21** `96653f0c196b`: 2 info
  - added the optional property `additional_lodging_data` to the response with the `201` status
  - added the optional property `additional_motor_vehicle_rental_data` to the response with the `201` status
- **2026-08-08** `5426f6f99c52`: 3 breaking
  - the `oneOf[subschema #10: Authorization - Lodging]/allOf[subschema #2: Authorization - All Fields]/statement_descriptor` request property's maxLength was decreased to `20`
  - the `oneOf[subschema #2: Authorization - All Fields]/statement_descriptor` request property's maxLength was decreased to `20`
  - the `oneOf[subschema #8: Authorization - Motor Vehicle Rental]/allOf[subschema #2: Authorization - All Fields]/statement_descriptor` request property's maxLength was decreased to `20`

---

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