---
title: "Changes to Create a billable metric"
method: POST
path: "/billable_metrics"
---

# Changes to Create a billable metric

`POST /billable_metrics`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 14 revisions.

- **2026-11-05** `b216574b9612`: 6 info
- **2026-10-16** `fce1879654d8`: 1 breaking, 1 info
- **2025-04-25** `86ccaf2d7c61`: 6 breaking, 2 warning, 2 info
- **2024-12-22** `e1b7ed77904e`: 1 breaking, 14 info
- **2024-12-09** `d7f5a2be797e`: 14 breaking, 5 warning, 9 info

## Changes

- **2026-11-05** `b216574b9612`: 6 info
  - the response property `billable_metric/description` became required for the status `200`
  - the response property `billable_metric/expression` became required for the status `200`
  - the response property `billable_metric/field_name` became required for the status `200`
  - the response property `billable_metric/rounding_function` became required for the status `200`
  - the response property `billable_metric/rounding_precision` became required for the status `200`
  - the response property `billable_metric/weighted_interval` became required for the status `200`
- **2026-10-16** `fce1879654d8`: 1 breaking, 1 info
  - the response property `billable_metric/expression` became nullable for the status `200`
  - the response property `billable_metric/filters` became required for the status `200`
- **2025-04-25** `86ccaf2d7c61`: 6 breaking, 2 warning, 2 info
  - the request property `billable_metric/description` became not nullable
  - the request property `billable_metric/expression` became not nullable
  - the request property `billable_metric/field_name` became not nullable
  - the request property `billable_metric/rounding_function` became not nullable
  - the request property `billable_metric/rounding_precision` became not nullable
  - the request property `billable_metric/weighted_interval` became not nullable
  - added the new `undefined` enum value to the `billable_metric/rounding_function` response property for the response status `200`
  - added the new `undefined` enum value to the `billable_metric/weighted_interval` response property for the response status `200`
  - added the new `undefined` enum value to the request property `billable_metric/rounding_function`
  - added the new `undefined` enum value to the request property `billable_metric/weighted_interval`
- **2024-12-22** `e1b7ed77904e`: 1 breaking, 14 info
  - the `billable_metric` response's property type changed from no type to `object` for status `200`
  - added the optional property `billable_metric/description` to the response with the `200` status
  - added the optional property `billable_metric/expression` to the response with the `200` status
  - added the optional property `billable_metric/field_name` to the response with the `200` status
  - added the optional property `billable_metric/filters` to the response with the `200` status
  - added the optional property `billable_metric/rounding_function` to the response with the `200` status
  - added the optional property `billable_metric/rounding_precision` to the response with the `200` status
  - added the optional property `billable_metric/weighted_interval` to the response with the `200` status
  - removed `#/components/schemas/BillableMetricObject, subschema #2` from the `billable_metric` response property `allOf` list for the response status `200`
  - added the required property `billable_metric/aggregation_type` to the response with the `200` status
  - added the required property `billable_metric/code` to the response with the `200` status
  - added the required property `billable_metric/created_at` to the response with the `200` status
  - added the required property `billable_metric/lago_id` to the response with the `200` status
  - added the required property `billable_metric/name` to the response with the `200` status
  - added the required property `billable_metric/recurring` to the response with the `200` status
- **2024-12-09** `d7f5a2be797e`: 14 breaking, 5 warning, 9 info
  - added the new required request property `billable_metric/aggregation_type`
  - added the new required request property `billable_metric/code`
  - added the new required request property `billable_metric/name`
  - the `billable_metric` request property type changed from no type to `object`
  - the `billable_metric` response's property type changed from `object` to no type for status `200`
  - removed the required property `billable_metric/active_subscriptions_count` from the response with the `200` status
  - removed the required property `billable_metric/aggregation_type` from the response with the `200` status
  - removed the required property `billable_metric/code` from the response with the `200` status
  - removed the required property `billable_metric/created_at` from the response with the `200` status
  - removed the required property `billable_metric/draft_invoices_count` from the response with the `200` status
  - removed the required property `billable_metric/lago_id` from the response with the `200` status
  - removed the required property `billable_metric/name` from the response with the `200` status
  - removed the required property `billable_metric/plans_count` from the response with the `200` status
  - removed the required property `billable_metric/recurring` from the response with the `200` status
  - removed `#/components/schemas/BillableMetricBaseInput, subschema #2` from the `billable_metric` request property `allOf` list
  - removed the optional property `billable_metric/description` from the response with the `200` status
  - removed the optional property `billable_metric/field_name` from the response with the `200` status
  - removed the optional property `billable_metric/filters` from the response with the `200` status
  - removed the optional property `billable_metric/weighted_interval` from the response with the `200` status
  - added the new optional request property `billable_metric/description`
  - added the new optional request property `billable_metric/expression`
  - added the new optional request property `billable_metric/field_name`
  - added the new optional request property `billable_metric/filters`
  - added the new optional request property `billable_metric/recurring`
  - added the new optional request property `billable_metric/rounding_function`
  - added the new optional request property `billable_metric/rounding_precision`
  - added the new optional request property `billable_metric/weighted_interval`
  - added `#/components/schemas/BillableMetricObject, subschema #2` to the `billable_metric` response property `allOf` list for the response status `200`

---

[Operation](https://skmtc.dev/getlago/apis/lago-api-documentation/docs/billable_metrics/post.md) - [API](https://skmtc.dev/getlago/apis/lago-api-documentation.md) - [Page](https://skmtc.dev/getlago/apis/lago-api-documentation/changes/billable_metrics/post)