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:

1. Build-a-Box discount recalculation
2. Product discount synchronization
3. Shipping price updates
4. Customer email notifications
5. 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

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>'

200

Success Response

{
  "id": "gid://shopify/SubscriptionContract/123456789",
  "status": "ACTIVE",
  "nextBillingDate": "2024-04-01T12:00:00Z",
  "customer": {
    "id": "gid://shopify/Customer/987654321",
    "email": "[e-mail]"
  },
  "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

200

application/json

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