--- title: "Changes to Create an adjustment" method: POST path: "/adjustments" --- # Changes to Create an adjustment `POST /adjustments` > Every recorded change to this operation, newest first. ## Timeline Changed in 8 of 19 revisions. - **2026-07-09** (v1) `e1ac347eb3c5`: 4 warning - **2026-02-02** (v1) `9ba8be0f2006`: 31 breaking, 10 warning, 85 info - **2025-05-27** (v1) `e57c515077cc`: 1 warning, 1 info - **2025-04-25** (v1) `c4b1322e66ca`: 1 info - **2024-12-06** (v1) `274e5b2be190`: 2 warning, 6 info - **2024-07-23** (v1) `e893d3157530`: 1 info - **2024-06-17** (v1) `0ea531d339dc`: 2 warning, 2 info - **2024-02-19** (v1) `a4a4068ff792`: 10 breaking, 16 warning, 9 info ## Changes - **2026-07-09** (v1) `e1ac347eb3c5`: 4 warning - added the new `CLP` enum value to the `data/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `201` - added the new `CLP` enum value to the `data/totals/allOf[subschema #1: AdjustmentTotals]/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `201` - added the new `PEN` enum value to the `data/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `201` - added the new `PEN` enum value to the `data/totals/allOf[subschema #1: AdjustmentTotals]/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `201` - **2026-02-02** (v1) `9ba8be0f2006`: 31 breaking, 10 warning, 85 info - request body became required - added `#/components/schemas/AdjustmentTaxMode` to the `tax_mode` request property `allOf` list - added `#/components/schemas/AdjustmentType` to the `type` request property `allOf` list - added `#/components/schemas/TransactionId` to the `transaction_id` request property `allOf` list - the request property `items` became not nullable - removed the enum value `external` of the request property `tax_mode` - removed the enum value `full` of the request property `type` - removed the enum value `internal` of the request property `tax_mode` - removed the enum value `partial` of the request property `type` - added the pattern `.*\S.*` to the request property `reason` - the `tax_mode` request property type changed from `string` to no type - the `transaction_id` request property type changed from `string` to no type - the `type` request property type changed from `string` to no type - the `data/currency_code` response property's maxLength was unset from `3` for the response status `201` - the `data/currency_code` response property's minLength was decreased from `3` to `0` for the response status `201` - the `data/created_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `201` - the `data/currency_code` response's property type changed from `string` to no type for status `201` - the `data/customer_id` response's property type changed from `string` to no type for status `201` - the `data/id` response's property type changed from `string` to no type for status `201` - the `data/items/items/` response's property type changed from no type to `object` for status `201` - the `data/status` response's property type changed from `string` to no type for status `201` - the `data/tax_rates_used/items/totals` response's property type changed from `object` to no type for status `201` - the `data/totals` response's property type changed from `object` to no type for status `201` - the `data/transaction_id` response's property type changed from `string` to no type for status `201` - the `data/type` response's property type changed from `string` to no type for status `201` - the `data/updated_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `201` - the `error` response's property type changed from `object` to no type for status `default` - removed the required property `error/code` from the response with the `default` status - removed the required property `error/detail` from the response with the `default` status - removed the required property `error/documentation_url` from the response with the `default` status - removed the required property `error/type` from the response with the `default` status - removed the optional property `data/tax_rates_used/items/totals/subtotal` from the response with the `201` status - removed the optional property `data/tax_rates_used/items/totals/tax` from the response with the `201` status - removed the optional property `data/tax_rates_used/items/totals/total` from the response with the `201` status - removed the optional property `data/totals/currency_code` from the response with the `201` status - removed the optional property `data/totals/earnings` from the response with the `201` status - removed the optional property `data/totals/fee` from the response with the `201` status - removed the optional property `data/totals/subtotal` from the response with the `201` status - removed the optional property `data/totals/tax` from the response with the `201` status - removed the optional property `data/totals/total` from the response with the `201` status - …86 more - **2025-05-27** (v1) `e57c515077cc`: 1 warning, 1 info - added the new `chargeback_warning_reverse` enum value to the `data/action` response property for the response status `201` - added the new `chargeback_warning_reverse` enum value to the request property `action` - **2025-04-25** (v1) `c4b1322e66ca`: 1 info - added the new optional request property `tax_mode` - **2024-12-06** (v1) `274e5b2be190`: 2 warning, 6 info - added the new `VND` enum value to the `data/currency_code` response property for the response status `201` - added the new `VND` enum value to the `data/totals/currency_code` response property for the response status `201` - added the new optional request property `type` - the request property `items` became nullable - the request property `items` became optional - added the new `VND` enum value to the request property `currency_code` - added the new `VND` enum value to the request property `totals/currency_code` - added the optional property `data/type` to the response with the `201` status - **2024-07-23** (v1) `e893d3157530`: 1 info - added the optional property `data/tax_rates_used` to the response with the `201` status - **2024-06-17** (v1) `0ea531d339dc`: 2 warning, 2 info - added the new `AUD` enum value to the `data/payout_totals/oneOf[subschema #1: Payout totals (adjustment)]/chargeback_fee/original/currency_code` response property for the response status `201` - added the new `CAD` enum value to the `data/payout_totals/oneOf[subschema #1: Payout totals (adjustment)]/chargeback_fee/original/currency_code` response property for the response status `201` - added the new `AUD` enum value to the request property `payout_totals/oneOf[subschema #1: Payout totals (adjustment)]/chargeback_fee/original/currency_code` - added the new `CAD` enum value to the request property `payout_totals/oneOf[subschema #1: Payout totals (adjustment)]/chargeback_fee/original/currency_code` - **2024-02-19** (v1) `a4a4068ff792`: 10 breaking, 16 warning, 9 info - the request property `items/items/allOf[subschema #2: Adjustment item]/proration` became not nullable - the request property `payout_totals` became not nullable - the request property `subscription_id` became not nullable - response property `data/credit_applied_to_balance` list-of-types was widened by adding types `null` to media type `application/json` of response `201` - added `#/components/schemas/adjustment_payout_totals, subschema #2` to the `data/payout_totals` response property `oneOf` list for the response status `201` - added `#/components/schemas/subscription_id, subschema #2` to the `data/subscription_id` response property `oneOf` list for the response status `201` - added `#/components/schemas/transaction_item_proration, subschema #2` to the `data/items/items/allOf[subschema #2: Adjustment item]/proration` response property `oneOf` list for the response status `201` - the `data/items/items/allOf[subschema #2: Adjustment item]/proration` response's property type changed from `object, null` to no type for status `201` - the `data/payout_totals` response's property type changed from `object, null` to no type for status `201` - the `data/subscription_id` response's property type changed from `string, null` to no type for status `201` - removed the request property `payout_totals/chargeback_fee` - removed the request property `payout_totals/currency_code` - removed the request property `payout_totals/earnings` - removed the request property `payout_totals/fee` - removed the request property `payout_totals/subtotal` - removed the request property `payout_totals/tax` - removed the request property `payout_totals/total` - removed the optional property `data/items/items/allOf[subschema #2: Adjustment item]/proration/billing_period` from the response with the `201` status - removed the optional property `data/items/items/allOf[subschema #2: Adjustment item]/proration/rate` from the response with the `201` status - removed the optional property `data/payout_totals/chargeback_fee` from the response with the `201` status - removed the optional property `data/payout_totals/currency_code` from the response with the `201` status - removed the optional property `data/payout_totals/earnings` from the response with the `201` status - removed the optional property `data/payout_totals/fee` from the response with the `201` status - removed the optional property `data/payout_totals/subtotal` from the response with the `201` status - removed the optional property `data/payout_totals/tax` from the response with the `201` status - removed the optional property `data/payout_totals/total` from the response with the `201` status - added `#/components/schemas/adjustment_payout_totals, subschema #2` to the `payout_totals` request property `oneOf` list - added `#/components/schemas/subscription_id, subschema #2` to the `subscription_id` request property `oneOf` list - added `#/components/schemas/transaction_item_proration, subschema #2` to the `items/items/allOf[subschema #2: Adjustment item]/proration` request property `oneOf` list - removed the pattern `^sub_[a-z\d]{26}$` from the request property `subscription_id` - removed the non-success response with the status `400` - removed the non-success response with the status `404` - removed the non-success response with the status `409` - removed the non-success response with the status `500` - the `data/subscription_id` response's property pattern `^sub_[a-z\d]{26}$` was removed for the status `201` --- [Operation](https://skmtc.dev/paddlehq/apis/paddle-api/docs/adjustments/post.md) - [API](https://skmtc.dev/paddlehq/apis/paddle-api.md) - [Page](https://skmtc.dev/paddlehq/apis/paddle-api/changes/adjustments/post)