Subscription Products

Update product line item price

Updates the base price of a specific product line item within a subscription contract. This endpoint intelligently handles pricing updates while preserving existing discount structures.

Full behavior, validation rules, and side effects

Key Features:

Updates base price while maintaining discount cycles
Automatically calculates prepaid subscription prices
Preserves existing percentage/fixed discounts
Validates actual price changes before updating
Triggers shipping and discount recalculations
Sends price update notifications to customers

Base Price vs Current Price:

Base Price: The unit price before any multipliers
Current Price: Base price × fulfillment multiplier
For monthly billing/weekly delivery: Current = Base × 4
For pay-per-delivery: Current = Base × 1

Discount Preservation: By default, this endpoint preserves existing discount cycles:

Percentage discounts adjust to new base price
Fixed discounts remain at same dollar amount
Discount schedule (after X cycles) unchanged

Prepaid Subscription Handling: For prepaid subscriptions (billing interval > delivery interval):

Automatically calculates fulfillment multiplier
Updates current price accordingly
Ensures correct billing amounts

Post-Update Actions:

Build-a-Box discount recalculation
Product discount synchronization
Shipping price updates
Customer email notifications
Activity log creation

Important Notes:

Price changes apply to future orders only
Cannot set price below $0.01
Maximum 2 discount cycles preserved
No update if price unchanged

Authentication: Requires valid X-API-Key header

PUT

/

api

/

external

/

v2

/

subscription-contracts-update-line-item-price

Update product line item price

curl --request PUT \
  --url https://subscription-admin.appstle.com/api/external/v2/subscription-contracts-update-line-item-price \
  --header 'X-API-Key: <x-api-key>'

{
  "id": "gid://shopify/SubscriptionContract/123456789",
  "status": "ACTIVE",
  "nextBillingDate": "2024-04-01T12:00:00Z",
  "customer": {
    "id": "gid://shopify/Customer/987654321",
    "email": "customer@example.com"
  },
  "billingPolicy": {
    "interval": "MONTH",
    "intervalCount": 1
  },
  "deliveryPolicy": {
    "interval": "WEEK",
    "intervalCount": 1
  },
  "lines": {
    "edges": [
      {
        "node": {
          "id": "gid://shopify/SubscriptionLine/111111",
          "quantity": 1,
          "variantId": "gid://shopify/ProductVariant/42549172011164",
          "title": "Premium Coffee - Monthly Supply",
          "currentPrice": {
            "amount": "99.96",
            "currencyCode": "USD"
          },
          "pricingPolicy": {
            "basePrice": {
              "amount": "24.99",
              "currencyCode": "USD"
            },
            "cycleDiscounts": [
              {
                "afterCycle": 3,
                "adjustmentType": "PERCENTAGE",
                "adjustmentValue": {
                  "percentage": 10
                },
                "computedPrice": {
                  "amount": "89.96",
                  "currencyCode": "USD"
                }
              }
            ]
          }
        }
      }
    ]
  }
}

Headers

X-API-Key

string

required

API Key for authentication

Query Parameters

contractId

integer<int64>

required

Subscription contract ID. Provide the numeric ID without the gid:// prefix

Required range: x >= 1

api_key

string

API Key (Deprecated - Use X-API-Key header instead)

basePrice

number<double>

required

New base price for the line item (unit price before multipliers)

Required range: 0.01 <= x <= 999999.99

lineId

string

required

Line item ID to update. Must be the full GraphQL ID including the gid:// prefix

Response

Line item price successfully updated

get__typename

string

id

string

createdAt

object

updatedAt

object

nextBillingDate

object

status

enum<string>

Available options:

ACTIVE,

PAUSED,

CANCELLED,

EXPIRED,

FAILED,

$UNKNOWN

deliveryPrice

object

Show child attributes

lastPaymentStatus

enum<string>

Available options:

SUCCEEDED,

FAILED,

$UNKNOWN

billingPolicy

object

Show child attributes

deliveryPolicy

object

Show child attributes

lines

object

Show child attributes

customerPaymentMethod

object

Show child attributes

deliveryMethod

object

Show child attributes

originOrder

object

Show child attributes

customer

object

Show child attributes

discounts

object

Show child attributes

note

string

customAttributes

object[]

Show child attributes

billingAttempts

object

Show child attributes

Update line item pricing policy with cycle-based discounts

Remove multiple products from subscription

Update product line item price

curl --request PUT \
  --url https://subscription-admin.appstle.com/api/external/v2/subscription-contracts-update-line-item-price \
  --header 'X-API-Key: <x-api-key>'

{
  "id": "gid://shopify/SubscriptionContract/123456789",
  "status": "ACTIVE",
  "nextBillingDate": "2024-04-01T12:00:00Z",
  "customer": {
    "id": "gid://shopify/Customer/987654321",
    "email": "customer@example.com"
  },
  "billingPolicy": {
    "interval": "MONTH",
    "intervalCount": 1
  },
  "deliveryPolicy": {
    "interval": "WEEK",
    "intervalCount": 1
  },
  "lines": {
    "edges": [
      {
        "node": {
          "id": "gid://shopify/SubscriptionLine/111111",
          "quantity": 1,
          "variantId": "gid://shopify/ProductVariant/42549172011164",
          "title": "Premium Coffee - Monthly Supply",
          "currentPrice": {
            "amount": "99.96",
            "currencyCode": "USD"
          },
          "pricingPolicy": {
            "basePrice": {
              "amount": "24.99",
              "currencyCode": "USD"
            },
            "cycleDiscounts": [
              {
                "afterCycle": 3,
                "adjustmentType": "PERCENTAGE",
                "adjustmentValue": {
                  "percentage": 10
                },
                "computedPrice": {
                  "amount": "89.96",
                  "currencyCode": "USD"
                }
              }
            ]
          }
        }
      }
    ]
  }
}