---
title: "Changes to Create billing plan credit grant"
method: POST
path: "/billing/credits/plan-grants"
---

# Changes to Create billing plan credit grant

`POST /billing/credits/plan-grants`

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

## Timeline

Changed in 13 of 230 revisions.

- **2026-10-19** `92f237cd6201`: 2 info
- **2026-09-17** `fe6c40d79596`: 11 info
- **2026-09-17** `d2fb8bb90eaf`: 1 info
- **2026-09-16** `d6b7758ad3d1`: 1 warning, 1 info
- **2026-09-11** `ed3a987d45c3`: 1 breaking, 1 info
- **2026-09-10** `8615a9997f76`: 12 info
- **2026-08-19** `0263312106ba`: 2 info
- **2026-08-11** `12e9d0ac19a9`: 2 info
- **2026-07-31** `c65df608000b`: 4 info
- **2026-07-09** `8da6172fc3e9`: 2 warning, 2 info
- **2026-07-01** `d026b6ff6735`: 6 info
- **2026-06-05** `c0d7b479cd11`: 3 warning
- **2026-06-04** `df525a3b6157`: 2 info

## Changes

- **2026-10-19** `92f237cd6201`: 2 info
  - added the new optional request property `warning_tiers`
  - added the required property `data/warning_tiers` to the response with the `201` status
- **2026-09-17** `fe6c40d79596`: 11 info
  - added the new optional request property `billing_mode`
  - added the new optional request property `price_tiers`
  - added the new optional request property `tier_mode`
  - added the new optional request property `unit_price`
  - added the new optional request property `unit_price_decimal`
  - added the optional property `data/price` to the response with the `201` status
  - added the optional property `data/tier_mode` to the response with the `201` status
  - added the optional property `data/unit_price` to the response with the `201` status
  - added the optional property `data/unit_price_decimal` to the response with the `201` status
  - added the required property `data/billing_mode` to the response with the `201` status
  - added the required property `data/price_tiers` to the response with the `201` status
- **2026-09-17** `d2fb8bb90eaf`: 1 info
  - added the required property `data/credit/ledger_authority` to the response with the `201` status
- **2026-09-16** `d6b7758ad3d1`: 1 warning, 1 info
  - added the new `quarterly` enum value to the `data/arrears_cadence/allOf[#/components/schemas/BillingArrearsCadence]/` response property for the response status `201`
  - added the new `quarterly` enum value to the request property `arrears_cadence/allOf[#/components/schemas/BillingArrearsCadence]/`
- **2026-09-11** `ed3a987d45c3`: 1 breaking, 1 info
  - removed the enum value `daily` of the request property `arrears_cadence/allOf[#/components/schemas/BillingArrearsCadence]/`
  - removed the `daily` enum value from the `data/arrears_cadence/allOf[#/components/schemas/BillingArrearsCadence]/` response property for the response status `201`
- **2026-09-10** `8615a9997f76`: 12 info
  - added the new optional request property `arrears_anchor`
  - added the new optional request property `arrears_cadence`
  - added the new optional request property `overdraft_limit`
  - added the new optional request property `postpaid_enabled`
  - added the new optional request property `postpaid_rate_per_unit`
  - added the new optional request property `postpaid_rate_per_unit_decimal`
  - added the optional property `data/arrears_anchor` to the response with the `201` status
  - added the optional property `data/arrears_cadence` to the response with the `201` status
  - added the optional property `data/overdraft_limit` to the response with the `201` status
  - added the optional property `data/postpaid_rate_per_unit` to the response with the `201` status
  - added the optional property `data/postpaid_rate_per_unit_decimal` to the response with the `201` status
  - added the required property `data/postpaid_enabled` to the response with the `201` status
- **2026-08-19** `0263312106ba`: 2 info
  - request property `can_buy_bundles` deprecated
  - response property `data/can_buy_bundles` deprecated
- **2026-08-11** `12e9d0ac19a9`: 2 info
  - added the new optional request property `company_credit_amount`
  - added the required property `data/company_credit_amount` to the response with the `201` status
- **2026-07-31** `c65df608000b`: 4 info
  - added the new optional request property `license_id`
  - added the new optional request property `scaling`
  - added the optional property `data/license_id` to the response with the `201` status
  - added the required property `data/scaling` to the response with the `201` status
- **2026-07-09** `8da6172fc3e9`: 2 warning, 2 info
  - added the new `every_6_months` enum value to the `data/reset_cadence/allOf[#/components/schemas/BillingPlanCreditGrantResetCadence]/` response property for the response status `201`
  - added the new `quarterly` enum value to the `data/reset_cadence/allOf[#/components/schemas/BillingPlanCreditGrantResetCadence]/` response property for the response status `201`
  - added the new `every_6_months` enum value to the request property `reset_cadence`
  - added the new `quarterly` enum value to the request property `reset_cadence`
- **2026-07-01** `d026b6ff6735`: 6 info
  - added the new optional request property `auto_topup_availability`
  - added the new optional request property `can_buy_bundles`
  - response property `data/auto_topup_enabled` deprecated
  - response property `data/auto_topup_self_service` deprecated
  - added the required property `data/auto_topup_availability` to the response with the `201` status
  - added the required property `data/can_buy_bundles` to the response with the `201` status
- **2026-06-05** `c0d7b479cd11`: 3 warning
  - added the new `metronome` enum value to the `data/credit/currency_prices/items/price/provider_type` response property for the response status `201`
  - added the new `metronome` enum value to the `data/credit/price/provider_type` response property for the response status `201`
  - added the new `metronome` enum value to the `data/credit/product/provider_type` response property for the response status `201`
- **2026-06-04** `df525a3b6157`: 2 info
  - added the new optional request property `rollover_percentage`
  - added the required property `data/rollover_percentage` to the response with the `201` status

---

[Operation](https://skmtc.dev/schematichq/apis/schematic-api/docs/billing/credits/plan-grants/post.md) - [API](https://skmtc.dev/schematichq/apis/schematic-api.md) - [Page](https://skmtc.dev/schematichq/apis/schematic-api/changes/billing/credits/plan-grants/post)
