---
title: "Changes to Assign a plan to a customer"
method: POST
path: "/subscriptions"
---

# Changes to Assign a plan to a customer

`POST /subscriptions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 3 revisions.

- **2026-11-05** `b216574b9612`: 1 warning
- **2026-11-03** `5d26657495a3`: 6 breaking, 5 warning, 33 info

## Changes

- **2026-11-05** `b216574b9612`: 1 warning
  - removed the request property `subscription/plan_overrides/metadata`
- **2026-11-03** `5d26657495a3`: 6 breaking, 5 warning, 33 info
  - the response property `subscription/allOf[subschema #2]/plan/description` became nullable for the status `200`
  - the response property `subscription/allOf[subschema #2]/plan/fixed_charges/items/invoice_display_name` became nullable for the status `200`
  - the response property `subscription/allOf[subschema #2]/plan/invoice_display_name` became nullable for the status `200`
  - the response property `subscription/allOf[subschema #2]/plan/minimum_commitment/invoice_display_name` became nullable for the status `200`
  - the response property `subscription/allOf[subschema #2]/plan/trial_period` became nullable for the status `200`
  - the `subscription/allOf[subschema #2]/plan/fixed_charges/items/units` response's property type changed from `number` to `string` for status `200`
  - added the new `SYP` enum value to the `subscription/allOf[#/components/schemas/SubscriptionObject]/plan_amount_currency` response property for the response status `200`
  - added the new `SYP` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200`
  - added the new `TND` enum value to the `subscription/allOf[#/components/schemas/SubscriptionObject]/plan_amount_currency` response property for the response status `200`
  - added the new `TND` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200`
  - added the new `manual` enum value to the `subscription/allOf[#/components/schemas/SubscriptionObject]/cancellation_reason` response property for the response status `200`
  - added the new optional request property `subscription/plan_overrides/charges/items/applied_pricing_unit/code`
  - added the new optional request property `subscription/progressive_billing_disabled`
  - added the new optional request property `subscription/purchase_order_number`
  - added the new optional request property `subscription/usage_thresholds`
  - request property `subscription/plan_overrides/usage_thresholds` deprecated
  - added the new `SYP` enum value to the request property `subscription/plan_overrides/amount_currency`
  - added the new `TND` enum value to the request property `subscription/plan_overrides/amount_currency`
  - added the non-success response with the status `403`
  - added the optional property `authorization` to the response with the `200` status
  - added the optional property `subscription/allOf[subschema #2]/entitlements` to the response with the `200` status
  - added the optional property `subscription/allOf[subschema #2]/plan/applicable_usage_thresholds` to the response with the `200` status
  - added the optional property `subscription/allOf[subschema #2]/plan/charges/items/filters/items/charge_code` to the response with the `200` status
  - added the optional property `subscription/allOf[subschema #2]/plan/charges/items/filters/items/lago_id` to the response with the `200` status
  - added the optional property `subscription/allOf[subschema #2]/plan/charges/items/taxes/items/applied_to_billing_entities_codes` to the response with the `200` status
  - added the optional property `subscription/allOf[subschema #2]/plan/fixed_charges/items/taxes/items/applied_to_billing_entities_codes` to the response with the `200` status
  - added the optional property `subscription/allOf[subschema #2]/plan/minimum_commitment/taxes/items/applied_to_billing_entities_codes` to the response with the `200` status
  - added the optional property `subscription/allOf[subschema #2]/plan/parent_id` to the response with the `200` status
  - added the optional property `subscription/allOf[subschema #2]/plan/pending_deletion` to the response with the `200` status
  - added the optional property `subscription/allOf[subschema #2]/plan/taxes/items/applied_to_billing_entities_codes` to the response with the `200` status
  - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/activated_at` became required for the status `200`
  - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/activation_rules` became required for the status `200`
  - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/activation_rules/items/expires_at` became required for the status `200`
  - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/cancellation_reason` became required for the status `200`
  - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/consolidate_invoice` became required for the status `200`
  - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/payment_method` became required for the status `200`
  - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/plan_amount_cents` became required for the status `200`
  - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/plan_amount_currency` became required for the status `200`
  - the response property `subscription/allOf[subschema #2]/plan/charges/items/taxes/items/description` became required for the status `200`
  - the response property `subscription/allOf[subschema #2]/plan/fixed_charges/items/taxes/items/description` became required for the status `200`
  - …4 more

---

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