---
title: "Changes to Create a new credit grant"
method: POST
path: "/openmeter/customers/{customerId}/credits/grants"
---

# Changes to Create a new credit grant

`POST /openmeter/customers/{customerId}/credits/grants`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 9 of 63 revisions.

- **2026-08-25** (v3) `bd7fb1027684` — 2 breaking, 2 info
- **2026-07-30** (v3) `b4f5102c436d` — 2 breaking, 1 warning, 3 info
- **2026-06-30** (v3) `16808fbfb578` — 1 info
- **2026-06-29** (v3) `cf64127756eb` — 2 info
- **2026-06-29** (v3) `e7e11dd3f78f` — 1 info
- **2026-06-28** (v3) `af0122bba090` — 1 info
- **2026-05-26** (v3) `66c58f249315` — 8 breaking, 10 warning, 4 info
- **2026-05-20** (v3) `55836d0ad2f5` — 2 info
- **2026-05-11** (v3) `9d0042cb3815` — 6 breaking, 9 warning, 14 info

## Changes

- **2026-08-25** (v3) `bd7fb1027684` — 2 breaking, 2 info
  - removed `#/components/schemas/CurrencyCode, #/components/schemas/BillingCurrencyCodeCustom` from the `currency/allOf[#/components/schemas/CreateCurrencyCode]/` request property `anyOf` list
  - added `#/components/schemas/CurrencyCode, #/components/schemas/BillingCurrencyCodeCustom` to the `currency/allOf[#/components/schemas/BillingCurrencyCode]/` response property `oneOf` list for the response status `201`
  - added `#/components/schemas/CurrencyCode, #/components/schemas/BillingCurrencyCodeCustom` to the `currency/allOf[#/components/schemas/CreateCurrencyCode]/` request property `oneOf` list
  - removed `#/components/schemas/CurrencyCode, #/components/schemas/BillingCurrencyCodeCustom` from the `currency/allOf[#/components/schemas/BillingCurrencyCode]/` response property `anyOf` list for the response status `201`
- **2026-07-30** (v3) `b4f5102c436d` — 2 breaking, 1 warning, 3 info
  - the `currency/allOf[#/components/schemas/CreateCurrencyCode]/` request property type changed from `string` to no type
  - the `currency/allOf[#/components/schemas/BillingCurrencyCode]/` response's property type changed from `string` to no type for status `201`
  - removed `#/components/schemas/CurrencyCode` from the `currency/allOf[#/components/schemas/CreateCurrencyCode]/` request property `allOf` list
  - added `#/components/schemas/CurrencyCode, #/components/schemas/BillingCurrencyCodeCustom` to the `currency/allOf[#/components/schemas/CreateCurrencyCode]/` request property `anyOf` list
  - removed `#/components/schemas/CurrencyCode` from the `currency/allOf[#/components/schemas/BillingCurrencyCode]/` response property `allOf` list for the response status `201`
  - added `#/components/schemas/CurrencyCode, #/components/schemas/BillingCurrencyCodeCustom` to the `currency/allOf[#/components/schemas/BillingCurrencyCode]/` response property `anyOf` list for the response status `201`
- **2026-06-30** (v3) `16808fbfb578` — 1 info
  - added the optional property `key` to the response with the `201` status
- **2026-06-29** (v3) `cf64127756eb` — 2 info
  - added the new optional request property `effective_at`
  - added the optional property `effective_at` to the response with the `201` status
- **2026-06-29** (v3) `e7e11dd3f78f` — 1 info
  - added the new optional request property `key`
- **2026-06-28** (v3) `af0122bba090` — 1 info
  - added the non-success response with the status `409`
- **2026-05-26** (v3) `66c58f249315` — 8 breaking, 10 warning, 4 info
  - added `#/components/schemas/CreateCreditGrantPurchase` to the `purchase` request property `allOf` list
  - added `#/components/schemas/CreateCreditGrantTaxConfig` to the `tax_config` request property `allOf` list
  - added `#/components/schemas/CreateCurrencyCode` to the `currency` request property `allOf` list
  - the `purchase` request property type changed from `object` to no type
  - the `invoice` response's property type changed from `object` to no type for status `201`
  - the `purchase` response's property type changed from `object` to no type for status `201`
  - removed the required property `purchase/amount` from the response with the `201` status
  - removed the required property `purchase/currency` from the response with the `201` status
  - removed `#/components/schemas/BillingCreditGrantTaxConfig` from the `tax_config` request property `allOf` list
  - removed `#/components/schemas/BillingCurrencyCode` from the `currency` request property `allOf` list
  - removed the request property `purchase/availability_policy`
  - removed the request property `purchase/currency`
  - removed the request property `purchase/per_unit_cost_basis`
  - removed the optional property `invoice/id` from the response with the `201` status
  - removed the optional property `invoice/line` from the response with the `201` status
  - removed the optional property `purchase/availability_policy` from the response with the `201` status
  - removed the optional property `purchase/per_unit_cost_basis` from the response with the `201` status
  - removed the optional property `purchase/settlement_status` from the response with the `201` status
  - added `#/components/schemas/BillingCreditGrantInvoiceReference` to the `invoice` response property `allOf` list for the response status `201`
  - added `#/components/schemas/BillingCreditGrantPurchase` to the `purchase` response property `allOf` list for the response status `201`
  - added `#/components/schemas/TaxCodeReference` to the `tax_config/allOf[subschema #1: Tax configuration for a credit grant]/tax_code` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/BillingTaxCodeReference` from the `tax_config/allOf[subschema #1: Tax configuration for a credit grant]/tax_code` response property `allOf` list for the response status `201`
- **2026-05-20** (v3) `55836d0ad2f5` — 2 info
  - added the new optional request property `expires_after`
  - added the optional property `expires_at` to the response with the `201` status
- **2026-05-11** (v3) `9d0042cb3815` — 6 breaking, 9 warning, 14 info
  - added the new required request property `purchase/currency`
  - added `#/components/schemas/BillingCreditGrantTaxConfig` to the `tax_config` request property `allOf` list
  - added `#/components/schemas/BillingCurrencyCode` to the `currency` request property `allOf` list
  - the `purchase` request property type changed from no type to `object`
  - the `invoice` response's property type changed from no type to `object` for status `201`
  - the `purchase` response's property type changed from no type to `object` for status `201`
  - removed `#/components/schemas/CreateCreditGrantPurchase` from the `purchase` request property `allOf` list
  - removed `#/components/schemas/CreateCreditGrantTaxConfig` from the `tax_config` request property `allOf` list
  - removed `#/components/schemas/CreateCurrencyCode` from the `currency` request property `allOf` list
  - removed the request property `effective_at`
  - removed the request property `expires_after`
  - removed the request property `key`
  - removed the optional property `effective_at` from the response with the `201` status
  - removed the optional property `expires_at` from the response with the `201` status
  - removed the optional property `key` from the response with the `201` status
  - added the new optional request property `purchase/availability_policy`
  - added the new optional request property `purchase/per_unit_cost_basis`
  - removed the non-success response with the status `409`
  - added the optional property `invoice/id` to the response with the `201` status
  - added the optional property `invoice/line` to the response with the `201` status
  - added the optional property `purchase/availability_policy` to the response with the `201` status
  - added the optional property `purchase/per_unit_cost_basis` to the response with the `201` status
  - added the optional property `purchase/settlement_status` to the response with the `201` status
  - added `#/components/schemas/BillingTaxCodeReference` to the `tax_config/allOf[subschema #1: Tax configuration for a credit grant]/tax_code` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/BillingCreditGrantInvoiceReference` from the `invoice` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/BillingCreditGrantPurchase` from the `purchase` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/TaxCodeReference` from the `tax_config/allOf[subschema #1: Tax configuration for a credit grant]/tax_code` response property `allOf` list for the response status `201`
  - added the required property `purchase/amount` to the response with the `201` status
  - added the required property `purchase/currency` to the response with the `201` status

---

[Operation](https://skmtc.dev/openmeterio/apis/openmeter-api/docs/openmeter/customers/:customerId/credits/grants/post.md) · [API](https://skmtc.dev/openmeterio/apis/openmeter-api.md) · [Page](https://skmtc.dev/openmeterio/apis/openmeter-api/changes/openmeter/customers/:customerId/credits/grants/post)