LOloopwork

Apply upgrade profile

Changed on

This endpoint allows you to apply an upgrade profile to a subscription contract.

post/2026-04/subscription/{subscriptionId}/upgrade

Request

  • Base URL
    https://api.loopsubscriptions.com/storefront
  • URL
    https://api.loopsubscriptions.com/storefront/2026-04/subscription/{subscriptionId}/upgrade
  • Auth
    API key in header Authorization

Path parameters

subscriptionIdinteger required

The unique identifier of the subscription in Loop.

Request body

profileIdinteger required

The ID of the upgrade profile to apply to the subscription. Retrieve this ID using the Fetch Upgrade Profiles API.

sourceLineIdinteger

The ID of the subscription line item to upgrade. Required for multi-line subscriptions when you want to upgrade a specific line item. Only line items with an available SKU upgrade option can be upgraded in multi-line subscriptions

variantShopifyIdinteger

The Shopify variant ID of the product to upgrade to. Use this when the upgrade profile has multiple products configured as upgrade options. If omitted, the subscription is upgraded to the first product configured in the personalized upgrade profile.

isMultiProductQuantityUpgradeboolean

Use this request parameter when applying "Product quantity + frequency change" upgrade. Pass true if the give line needs to upgraded to multiple products. Defaults to false

Response

Upgrade profile appied to the given subscription successfully

successboolean
messagestring
dataunknown
codestring
pageInfounknown

Example response

{
  "success": true,
  "message": "Subscription upgraded successfully",
  "code": "SUCCESS"
}

Changes