# Update selling plan for a subscription line item

Updates the selling plan associated with a specific product line item in a subscription contract. Selling plans define the delivery schedule, pricing rules, and billing policies for subscription products.

What are Selling Plans?
Selling plans are Shopify's way of defining subscription rules for products:
- Delivery Schedule: How often the product is delivered (e.g., 'every 2 weeks', 'monthly')
- Pricing Policy: Discounts and pricing tiers (e.g., '10% off', 'first order free')
- Billing Policy: When and how often customer is charged
- Plan Name: Customer-facing description like 'Deliver every month'

Key Features:
- Update by selling plan ID or name (name takes precedence if both provided)
- Validates line item exists before attempting update
- Only creates activity log if plan actually changes
- Uses Shopify's draft system for safe updates
- Preserves existing line item attributes and customizations

Common Use Cases:
- Change delivery frequency: Weekly → Monthly
- Switch pricing tiers: Regular → VIP pricing
- Update from old plan to new plan with better terms
- Migrate products to new selling plan groups
- Apply seasonal or promotional plans

Update Process:
1. Validates subscription contract and line item exist
2. Creates a draft of the subscription contract
3. Updates the line item's selling plan in the draft
4. Commits the draft to apply changes
5. Records activity log if plan changed

Impact of Selling Plan Changes:
- Delivery Schedule: Next and future orders follow new schedule
- Pricing: New plan's pricing applies from next billing
- Discounts: Plan-specific discounts are recalculated
- Billing: Billing frequency may change with the plan

Finding Selling Plans:
To find available selling plans:
1. Check product's selling plan groups in Shopify admin
2. Use Shopify's GraphQL API to query selling plans
3. Plans must be active and associated with the product

Important Notes:
- Both sellingPlanId and sellingPlanName are optional, but at least one required
- If both provided, both are updated (name doesn't override ID)
- Plan must be valid for the product variant
- Changes apply to future orders only
- No customer notification sent (consider sending separately)

Authentication: Requires valid X-API-Key header

Endpoint: PUT /api/external/v2/subscription-contracts-update-line-item-selling-plan
Version: 0.0.1

## Query parameters:

  - `contractId` (integer, required)
    The unique identifier of the subscription contract
    Example: 123456789

  - `lineId` (string, required)
    The unique identifier of the line item in the subscription contract. Must be in full GraphQL ID format
    Example: "gid://shopify/SubscriptionLine/987654321"

  - `sellingPlanId` (integer)
    The unique identifier of the new selling plan. Provide the numeric ID without gid:// prefix. Required if sellingPlanName is not provided. The plan must be:
- Active in your Shopify store
- Associated with the product variant
- Part of an active selling plan group
    Example: 56789

  - `sellingPlanName` (string)
    The customer-facing name of the new selling plan. Required if sellingPlanId is not provided. This is the name shown to customers like 'Deliver every 2 weeks' or 'Monthly subscription'. Must match exactly as configured in Shopify
    Example: "Deliver every month"

## Header parameters:

  - `X-API-Key` (string, required)
    API Key for authentication
    Example: "sk_live_1234567890abcdef"

## Response 200 fields (application/json):

  - `get__typename` (string)

  - `id` (string)

  - `createdAt` (object)

  - `updatedAt` (object)

  - `nextBillingDate` (object)

  - `status` (string)
    Enum: "ACTIVE", "PAUSED", "CANCELLED", "EXPIRED", "FAILED", "$UNKNOWN"

  - `deliveryPrice` (object)

  - `deliveryPrice.amount` (object)

  - `deliveryPrice.currencyCode` (string)
    Enum: "USD", "EUR", "GBP", "CAD", "AFN", "ALL", "DZD", "AOA", "ARS", "AMD", "AWG", "AUD", "BBD", "AZN", "BDT", "BSD", "BHD", "BIF", "BYN", "BZD", "BMD", "BTN", "BAM", "BRL", "BOB", "BWP", "BND", "BGN", "MMK", "KHR", "CVE", "KYD", "XAF", "CLP", "CNY", "COP", "KMF", "CDF", "CRC", "HRK", "CZK", "DKK", "DJF", "DOP", "XCD", "EGP", "ERN", "ETB", "FKP", "XPF", "FJD", "GIP", "GMD", "GHS", "GTQ", "GYD", "GEL", "GNF", "HTG", "HNL", "HKD", "HUF", "ISK", "INR", "IDR", "ILS", "IRR", "IQD", "JMD", "JPY", "JEP", "JOD", "KZT", "KES", "KID", "KWD", "KGS", "LAK", "LVL", "LBP", "LSL", "LRD", "LYD", "LTL", "MGA", "MKD", "MOP", "MWK", "MVR", "MRU", "MXN", "MYR", "MUR", "MDL", "MAD", "MNT", "MZN", "NAD", "NPR", "ANG", "NZD", "NIO", "NGN", "NOK", "OMR", "PAB", "PKR", "PGK", "PYG", "PEN", "PHP", "PLN", "QAR", "RON", "RUB", "RWF", "WST", "SHP", "SAR", "RSD", "SCR", "SLL", "SGD", "SDG", "SOS", "SYP", "ZAR", "KRW", "SSP", "SBD", "LKR", "SRD", "SZL", "SEK", "CHF", "TWD", "THB", "TJS", "TZS", "TOP", "TTD", "TND", "TRY", "TMT", "UGX", "UAH", "AED", "UYU", "UZS", "VUV", "VES", "VND", "XOF", "YER", "ZMW", "USDC", "BYR", "STD", "STN", "VED", "VEF", "XXX", "$UNKNOWN"

  - `lastPaymentStatus` (string)
    Enum: "SUCCEEDED", "FAILED", "$UNKNOWN"

  - `billingPolicy` (object)

  - `billingPolicy.interval` (string)
    Enum: "DAY", "WEEK", "MONTH", "YEAR", "$UNKNOWN"

  - `billingPolicy.intervalCount` (integer)

  - `billingPolicy.anchors` (array)

  - `billingPolicy.anchors.cutoffDay` (integer)

  - `billingPolicy.anchors.day` (integer)

  - `billingPolicy.anchors.month` (integer)

  - `billingPolicy.anchors.type` (string)
    Enum: "WEEKDAY", "MONTHDAY", "YEARDAY", "$UNKNOWN"

  - `billingPolicy.maxCycles` (integer)

  - `billingPolicy.minCycles` (integer)

  - `deliveryPolicy` (object)

  - `lines` (object)

  - `lines.nodes` (array)

  - `lines.nodes.sellingPlanId` (string)

  - `lines.nodes.sellingPlanName` (string)

  - `lines.nodes.productId` (string)

  - `lines.nodes.sku` (string)

  - `lines.nodes.title` (string)

  - `lines.nodes.variantId` (string)

  - `lines.nodes.quantity` (integer)

  - `lines.nodes.customAttributes` (array)

  - `lines.nodes.customAttributes.key` (string)

  - `lines.nodes.customAttributes.value` (string)

  - `lines.nodes.lineDiscountedPrice` (object)

  - `lines.nodes.variantImage` (object)

  - `lines.nodes.variantImage.transformedSrc` (object)

  - `lines.nodes.variantTitle` (string)

  - `lines.nodes.currentPrice` (object)

  - `lines.nodes.discountAllocations` (array)

  - `lines.nodes.discountAllocations.discount` (object)

  - `lines.nodes.pricingPolicy` (object)

  - `lines.nodes.pricingPolicy.basePrice` (object)

  - `lines.nodes.pricingPolicy.cycleDiscounts` (array)

  - `lines.nodes.pricingPolicy.cycleDiscounts.afterCycle` (integer)

  - `lines.nodes.pricingPolicy.cycleDiscounts.computedPrice` (object)

  - `lines.nodes.pricingPolicy.cycleDiscounts.adjustmentType` (string)
    Enum: "PERCENTAGE", "FIXED_AMOUNT", "PRICE", "$UNKNOWN"

  - `lines.nodes.pricingPolicy.cycleDiscounts.adjustmentValue` (object)

  - `lines.nodes.taxable` (boolean)

  - `lines.pageInfo` (object)

  - `lines.pageInfo.hasPreviousPage` (boolean)

  - `lines.pageInfo.hasNextPage` (boolean)

  - `lines.pageInfo.startCursor` (string)

  - `lines.pageInfo.endCursor` (string)

  - `customerPaymentMethod` (object)

  - `customerPaymentMethod.instrument` (object)

  - `customerPaymentMethod.revokedAt` (object)

  - `customerPaymentMethod.revokedReason` (string)
    Enum: "AUTHORIZE_NET_GATEWAY_NOT_ENABLED", "AUTHORIZE_NET_RETURNED_NO_PAYMENT_METHOD", "FAILED_TO_UPDATE_CREDIT_CARD", "STRIPE_API_AUTHENTICATION_ERROR", "STRIPE_API_INVALID_REQUEST_ERROR", "STRIPE_GATEWAY_NOT_ENABLED", "STRIPE_RETURNED_NO_PAYMENT_METHOD", "STRIPE_PAYMENT_METHOD_NOT_CARD", "BRAINTREE_API_AUTHENTICATION_ERROR", "BRAINTREE_GATEWAY_NOT_ENABLED", "BRAINTREE_RETURNED_NO_PAYMENT_METHOD", "BRAINTREE_PAYMENT_METHOD_NOT_CARD", "PAYMENT_METHOD_VERIFICATION_FAILED", "THREE_D_SECURE_FLOW_IN_VERIFICATION_NOT_IMPLEMENTED", "MANUALLY_REVOKED", "FAILED_TO_RETRIEVE_BILLING_ADDRESS", "MERGED", "CUSTOMER_REDACTED", "TOO_MANY_CONSECUTIVE_FAILURES", "CVV_ATTEMPTS_LIMIT_EXCEEDED", "$UNKNOWN"

  - `deliveryMethod` (object)

  - `originOrder` (object)

  - `originOrder.name` (string)

  - `originOrder.fulfillmentOrders` (object)

  - `customer` (object)

  - `customer.displayName` (string)

  - `customer.firstName` (string)

  - `customer.lastName` (string)

  - `customer.email` (string)

  - `customer.phone` (string)

  - `discounts` (object)

  - `note` (string)

  - `billingAttempts` (object)


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 404 fields

## Response 422 fields