Edit a subscription

Once a plan has been assigned to a customer, whether it’s in a pending or active state, you can make edits to the subscription by following these steps:

Dashboard
API

Click on the three dots menu icon and select “Edit subscription.”
Subscription Start and End Date
You have the ability to modify the subscription start date if the subscription is pending, and if the chosen date is later than today. It’s important to refer to the guidelines for subscription start date for further information.
Subscription End Date
You can also make changes to the subscription end date, but it’s important to refer to the guidelines for subscription end date for further information.
You can edit any prices listed for a subscription, including charges, commitments, tiers and spending minimums.

LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"

curl --location --request PUT "$LAGO_URL/api/v1/subscriptions/{external_id}" \
  --header "Authorization: Bearer $API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "subscription": {
    "name": "",
    "subscription_at": "2022-08-08T00:00:00Z",
    "ending_at": "2023-08-08T00:00:00Z",
    "plan_overrides": {
      "name": "new_plan",
      "invoice_display_name": "Subscription fee",
      "description": "Overriden plan for customer X",
      "charges": [
        {
          "id": "cac4cff7-e2d9-41e2-83e5-7947d91f0eb5",
          "invoice_display_name": "Cards - custom price",
          "properties": {
            "amount": "10"
          },
          "group_properties": [],
        }
      ],
      "fixed_charges": [
        {
          "id": "af360881-357a-4334-ad16-8cd38e246d03",
          "units": 20,
          "apply_units_immediately": true
        }
      ]
    }
  }
}'

Fixed charges are updated under plan_overrides, using the fixed_charges array. Sending only units (and apply_units_immediately if needed) updates the quantity without creating a plan override. Passing a price or properties creates one. See Update a fixed charge via the API.

Upgrades and downgrades Terminate a subscription

⌘I