---
title: "Changes to Create custom plan"
method: POST
path: "/custom-plans"
---

# Changes to Create custom plan

`POST /custom-plans`

> Every recorded change to this operation, newest first.
> 230 revisions in range; 1 not diffed.

## Timeline

Changed in 28 of 230 revisions.

- **2026-10-20** `c7dea159ac06`: 3 info
- **2026-10-19** `92f237cd6201`: 1 info
- **2026-10-15** `cdb3124e1bed`: 2 breaking, 1 info
- **2026-10-06** `8eb4adb2bade`: 4 info
- **2026-09-17** `fe6c40d79596`: 6 info
- **2026-09-17** `d2fb8bb90eaf`: 3 info
- **2026-09-16** `d6b7758ad3d1`: 2 warning
- **2026-09-16** `6cf39110fd8f`: 2 info
- **2026-09-11** `ed3a987d45c3`: 1 info
- **2026-09-10** `8615a9997f76`: 6 info
- **2026-09-02** `e6877e252959`: 2 info
- **2026-08-21** `84d047c6d921`: 1 info
- **2026-08-19** `0263312106ba`: 1 info
- **2026-08-18** `ca9c0227b918`: 1 info
- **2026-08-11** `12e9d0ac19a9`: 1 info
- **2026-07-31** `c65df608000b`: 2 info
- **2026-07-30** `fad9064655ad`: 2 breaking
- **2026-07-27** `e83d3358bab3`: 3 warning, 6 info
- **2026-07-16** `fe536614b280`: 1 info
- **2026-07-09** `068d6aa15d38`: 1 info
- **2026-07-09** `8da6172fc3e9`: 2 warning
- **2026-07-01** `61365e38074b`: 1 info
- **2026-07-01** `d026b6ff6735`: 4 info
- **2026-06-30** `2046c618ab01`: 1 info
- **2026-06-05** `c0d7b479cd11`: 30 warning
- **2026-06-04** `df525a3b6157`: 1 info
- **2026-05-30** `18d59f1bf692`: 1 info
- **2026-05-19** `9f854e7c7b1c`: 1 warning, 2 info

## Changes

- **2026-10-20** `c7dea159ac06`: 3 info
  - added the required property `data/active_version/renewal_policy` to the response with the `201` status
  - added the required property `data/draft_version/renewal_policy` to the response with the `201` status
  - added the required property `data/versions/items/renewal_policy` to the response with the `201` status
- **2026-10-19** `92f237cd6201`: 1 info
  - added the required property `data/included_credit_grants/items/warning_tiers` to the response with the `201` status
- **2026-10-15** `cdb3124e1bed`: 2 breaking, 1 info
  - the response property `data/features/items/flags/items/default_value` became nullable for the status `201`
  - the response property `data/features/items/flags/items/default_value` became optional for the status `201`
  - response property `data/features/items/flags/items/default_value` deprecated
- **2026-10-06** `8eb4adb2bade`: 4 info
  - added the optional property `data/entitlements/items/quantity_rates` to the response with the `201` status
  - added the required property `data/entitlements/items/feature/event_source` to the response with the `201` status
  - added the required property `data/features/items/event_source` to the response with the `201` status
  - added the required property `data/features/items/flags/items/feature/event_source` to the response with the `201` status
- **2026-09-17** `fe6c40d79596`: 6 info
  - added the optional property `data/included_credit_grants/items/price` to the response with the `201` status
  - added the optional property `data/included_credit_grants/items/tier_mode` to the response with the `201` status
  - added the optional property `data/included_credit_grants/items/unit_price` to the response with the `201` status
  - added the optional property `data/included_credit_grants/items/unit_price_decimal` to the response with the `201` status
  - added the required property `data/included_credit_grants/items/billing_mode` to the response with the `201` status
  - added the required property `data/included_credit_grants/items/price_tiers` to the response with the `201` status
- **2026-09-17** `d2fb8bb90eaf`: 3 info
  - added the required property `data/credits/items/ledger_authority` to the response with the `201` status
  - added the required property `data/entitlements/items/value_credit/ledger_authority` to the response with the `201` status
  - added the required property `data/included_credit_grants/items/credit/ledger_authority` to the response with the `201` status
- **2026-09-16** `d6b7758ad3d1`: 2 warning
  - added the new `quarterly` enum value to the `data/entitlements/items/overage_billing_cadence/allOf[#/components/schemas/BillingArrearsCadence]/` response property for the response status `201`
  - added the new `quarterly` enum value to the `data/included_credit_grants/items/arrears_cadence/allOf[#/components/schemas/BillingArrearsCadence]/` response property for the response status `201`
- **2026-09-16** `6cf39110fd8f`: 2 info
  - added the optional property `data/entitlements/items/overage_billing_cadence` to the response with the `201` status
  - added the optional property `data/entitlements/items/overage_invoice_anchor` to the response with the `201` status
- **2026-09-11** `ed3a987d45c3`: 1 info
  - removed the `daily` enum value from the `data/included_credit_grants/items/arrears_cadence/allOf[#/components/schemas/BillingArrearsCadence]/` response property for the response status `201`
- **2026-09-10** `8615a9997f76`: 6 info
  - added the optional property `data/included_credit_grants/items/arrears_anchor` to the response with the `201` status
  - added the optional property `data/included_credit_grants/items/arrears_cadence` to the response with the `201` status
  - added the optional property `data/included_credit_grants/items/overdraft_limit` to the response with the `201` status
  - added the optional property `data/included_credit_grants/items/postpaid_rate_per_unit` to the response with the `201` status
  - added the optional property `data/included_credit_grants/items/postpaid_rate_per_unit_decimal` to the response with the `201` status
  - added the required property `data/included_credit_grants/items/postpaid_enabled` to the response with the `201` status
- **2026-09-02** `e6877e252959`: 2 info
  - added the optional property `data/features/items/flags/items/rules/items/condition_groups/items/conditions/items/plan_versions` to the response with the `201` status
  - added the optional property `data/features/items/flags/items/rules/items/conditions/items/plan_versions` to the response with the `201` status
- **2026-08-21** `84d047c6d921`: 1 info
  - the request property `description` became optional
- **2026-08-19** `0263312106ba`: 1 info
  - response property `data/included_credit_grants/items/can_buy_bundles` deprecated
- **2026-08-18** `ca9c0227b918`: 1 info
  - added the new optional request property `copied_price_id`
- **2026-08-11** `12e9d0ac19a9`: 1 info
  - added the required property `data/included_credit_grants/items/company_credit_amount` to the response with the `201` status
- **2026-07-31** `c65df608000b`: 2 info
  - added the optional property `data/included_credit_grants/items/license_id` to the response with the `201` status
  - added the required property `data/included_credit_grants/items/scaling` to the response with the `201` status
- **2026-07-30** `fad9064655ad`: 2 breaking
  - the response property `data/is_free` became nullable for the status `201`
  - the response property `data/is_free` became optional for the status `201`
- **2026-07-27** `e83d3358bab3`: 3 warning, 6 info
  - added the new `license` enum value to the `data/entitlements/items/feature/feature_type` response property for the response status `201`
  - added the new `license` enum value to the `data/features/items/feature_type` response property for the response status `201`
  - added the new `license` enum value to the `data/features/items/flags/items/feature/feature_type` response property for the response status `201`
  - added the optional property `data/entitlements/items/feature/license_id` to the response with the `201` status
  - added the optional property `data/entitlements/items/feature/usage_limit_trait_id` to the response with the `201` status
  - added the optional property `data/features/items/flags/items/feature/license_id` to the response with the `201` status
  - added the optional property `data/features/items/flags/items/feature/usage_limit_trait_id` to the response with the `201` status
  - added the optional property `data/features/items/license_id` to the response with the `201` status
  - added the optional property `data/features/items/usage_limit_trait_id` to the response with the `201` status
- **2026-07-16** `fe536614b280`: 1 info
  - added the optional property `data/catalogs` to the response with the `201` status
- **2026-07-09** `068d6aa15d38`: 1 info
  - added the required property `data/entitlements/items/warning_tiers` to the response with the `201` status
- **2026-07-09** `8da6172fc3e9`: 2 warning
  - added the new `every_6_months` enum value to the `data/included_credit_grants/items/reset_cadence/allOf[#/components/schemas/BillingPlanCreditGrantResetCadence]/` response property for the response status `201`
  - added the new `quarterly` enum value to the `data/included_credit_grants/items/reset_cadence/allOf[#/components/schemas/BillingPlanCreditGrantResetCadence]/` response property for the response status `201`
- **2026-07-01** `61365e38074b`: 1 info
  - added the required property `data/credits` to the response with the `201` status
- **2026-07-01** `d026b6ff6735`: 4 info
  - response property `data/included_credit_grants/items/auto_topup_enabled` deprecated
  - response property `data/included_credit_grants/items/auto_topup_self_service` deprecated
  - added the required property `data/included_credit_grants/items/auto_topup_availability` to the response with the `201` status
  - added the required property `data/included_credit_grants/items/can_buy_bundles` to the response with the `201` status
- **2026-06-30** `2046c618ab01`: 1 info
  - added the optional property `data/company_logo_url` to the response with the `201` status
- **2026-06-05** `c0d7b479cd11`: 30 warning
  - added the new `metronome` enum value to the `data/billing_linked_resource/billing_provider` response property for the response status `201`
  - added the new `metronome` enum value to the `data/billing_linked_resource/originator` response property for the response status `201`
  - added the new `metronome` enum value to the `data/billing_product/prices/items/provider_type` response property for the response status `201`
  - added the new `metronome` enum value to the `data/billing_product/provider_type` response property for the response status `201`
  - added the new `metronome` enum value to the `data/controlled_by` response property for the response status `201`
  - added the new `metronome` enum value to the `data/currency_prices/items/monthly_price/provider_type` response property for the response status `201`
  - added the new `metronome` enum value to the `data/currency_prices/items/one_time_price/provider_type` response property for the response status `201`
  - added the new `metronome` enum value to the `data/currency_prices/items/quarterly_price/provider_type` response property for the response status `201`
  - added the new `metronome` enum value to the `data/currency_prices/items/yearly_price/provider_type` response property for the response status `201`
  - added the new `metronome` enum value to the `data/entitlements/items/billing_linked_resource/billing_provider` response property for the response status `201`
  - added the new `metronome` enum value to the `data/entitlements/items/billing_linked_resource/originator` response property for the response status `201`
  - added the new `metronome` enum value to the `data/entitlements/items/currency_prices/items/monthly_price/provider_type` response property for the response status `201`
  - added the new `metronome` enum value to the `data/entitlements/items/currency_prices/items/quarterly_price/provider_type` response property for the response status `201`
  - added the new `metronome` enum value to the `data/entitlements/items/currency_prices/items/yearly_price/provider_type` response property for the response status `201`
  - added the new `metronome` enum value to the `data/entitlements/items/metered_monthly_price/provider_type` response property for the response status `201`
  - added the new `metronome` enum value to the `data/entitlements/items/metered_quarterly_price/provider_type` response property for the response status `201`
  - added the new `metronome` enum value to the `data/entitlements/items/metered_yearly_price/provider_type` response property for the response status `201`
  - added the new `metronome` enum value to the `data/entitlements/items/usage_based_product/provider_type` response property for the response status `201`
  - added the new `metronome` enum value to the `data/entitlements/items/value_credit/currency_prices/items/price/provider_type` response property for the response status `201`
  - added the new `metronome` enum value to the `data/entitlements/items/value_credit/price/provider_type` response property for the response status `201`
  - added the new `metronome` enum value to the `data/entitlements/items/value_credit/product/provider_type` response property for the response status `201`
  - added the new `metronome` enum value to the `data/features/items/billing_linked_resource/billing_provider` response property for the response status `201`
  - added the new `metronome` enum value to the `data/features/items/billing_linked_resource/originator` response property for the response status `201`
  - added the new `metronome` enum value to the `data/included_credit_grants/items/credit/currency_prices/items/price/provider_type` response property for the response status `201`
  - added the new `metronome` enum value to the `data/included_credit_grants/items/credit/price/provider_type` response property for the response status `201`
  - added the new `metronome` enum value to the `data/included_credit_grants/items/credit/product/provider_type` response property for the response status `201`
  - added the new `metronome` enum value to the `data/monthly_price/provider_type` response property for the response status `201`
  - added the new `metronome` enum value to the `data/one_time_price/provider_type` response property for the response status `201`
  - added the new `metronome` enum value to the `data/quarterly_price/provider_type` response property for the response status `201`
  - added the new `metronome` enum value to the `data/yearly_price/provider_type` response property for the response status `201`
- **2026-06-04** `df525a3b6157`: 1 info
  - added the required property `data/included_credit_grants/items/rollover_percentage` to the response with the `201` status
- **2026-05-30** `18d59f1bf692`: 1 info
  - added the optional property `data/entitlements` to the response with the `201` status
- **2026-05-19** `9f854e7c7b1c`: 1 warning, 2 info
  - added the new `none` enum value to the `data/charge_type` response property for the response status `201`
  - response property `data/is_free` deprecated
  - added the required property `data/billing_strategy` to the response with the `201` status

---

[Operation](https://skmtc.dev/schematichq/apis/schematic-api/docs/custom-plans/post.md) - [API](https://skmtc.dev/schematichq/apis/schematic-api.md) - [Page](https://skmtc.dev/schematichq/apis/schematic-api/changes/custom-plans/post)
