---
title: "Changes to Create a new subscription add-on"
method: POST
path: "/openmeter/subscriptions/{subscriptionId}/addons"
---

# Changes to Create a new subscription add-on

`POST /openmeter/subscriptions/{subscriptionId}/addons`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 107 revisions.

- **2026-09-21** (v3) `159bfd1e78cf`: 2 info
- **2026-08-25** (v3) `bd7fb1027684`: 1 breaking, 1 info
- **2026-07-30** (v3) `b4f5102c436d`: 1 info
- **2026-07-03** (v3) `3be06f269447`: 2 info
- **2026-06-29** (v3) `0c83f69f9f5d`: 1 info
- **2026-05-11** (v3) `9d0042cb3815`: 1 breaking

## Changes

- **2026-09-21** (v3) `159bfd1e78cf`: 2 info
  - added `#/components/schemas/TaxCodeConfig` to the `rate_cards/items/rate_card/allOf[#/components/schemas/BillingRateCard]/tax_config` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/BillingRateCardTaxConfig` from the `rate_cards/items/rate_card/allOf[#/components/schemas/BillingRateCard]/tax_config` response property `allOf` list for the response status `201`
- **2026-08-25** (v3) `bd7fb1027684`: 1 breaking, 1 info
  - added `#/components/schemas/CurrencyCode, #/components/schemas/BillingCurrencyCodeCustom` to the `rate_cards/items/rate_card/allOf[#/components/schemas/BillingRateCard]/currency/allOf[#/components/schemas/BillingCurrencyCode]/` response property `oneOf` list for the response status `201`
  - removed `#/components/schemas/CurrencyCode, #/components/schemas/BillingCurrencyCodeCustom` from the `rate_cards/items/rate_card/allOf[#/components/schemas/BillingRateCard]/currency/allOf[#/components/schemas/BillingCurrencyCode]/` response property `anyOf` list for the response status `201`
- **2026-07-30** (v3) `b4f5102c436d`: 1 info
  - added the optional property `rate_cards/items/rate_card/allOf[#/components/schemas/BillingRateCard]/currency` to the response with the `201` status
- **2026-07-03** (v3) `3be06f269447`: 2 info
  - added `#/components/schemas/FeatureReference` to the `rate_cards/items/rate_card/allOf[#/components/schemas/BillingRateCard]/feature` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/FeatureReferenceItem` from the `rate_cards/items/rate_card/allOf[#/components/schemas/BillingRateCard]/feature` response property `allOf` list for the response status `201`
- **2026-06-29** (v3) `0c83f69f9f5d`: 1 info
  - endpoint added
- **2026-05-11** (v3) `9d0042cb3815`: 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/openmeterio/apis/openmeter-api/docs/openmeter/subscriptions/:subscriptionId/addons/post.md) · [API](https://skmtc.dev/openmeterio/apis/openmeter-api.md) · [Page](https://skmtc.dev/openmeterio/apis/openmeter-api/changes/openmeter/subscriptions/:subscriptionId/addons/post)