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:
Key Features:
Common Use Cases:
Update Process:
Impact of Selling Plan Changes:
Finding Selling Plans: To find available selling plans:
Important Notes:
Authentication: Requires valid X-API-Key header
curl --request PUT \
--url https://subscription-admin.appstle.com/api/external/v2/subscription-contracts-update-line-item-selling-plan \
--header 'X-API-Key: <x-api-key>'{
"id": "gid://shopify/SubscriptionContract/123456789",
"status": "ACTIVE",
"nextBillingDate": "2024-04-01T00:00:00Z",
"customer": {
"id": "gid://shopify/Customer/987654321",
"email": "customer@example.com"
},
"lines": {
"edges": [
{
"node": {
"id": "gid://shopify/SubscriptionLine/987654321",
"quantity": 2,
"variantId": "gid://shopify/ProductVariant/42549172011164",
"title": "Premium Coffee - Dark Roast",
"currentPrice": {
"amount": "27.99",
"currencyCode": "USD"
},
"sellingPlanId": "gid://shopify/SellingPlan/56789",
"sellingPlanName": "Deliver every month",
"pricingPolicy": {
"basePrice": {
"amount": "29.99",
"currencyCode": "USD"
},
"cycleDiscounts": [
{
"afterCycle": 0,
"adjustmentType": "PERCENTAGE",
"adjustmentValue": {
"percentage": 10
}
}
]
}
}
}
]
},
"deliveryPolicy": {
"interval": "MONTH",
"intervalCount": 1
}
}Documentation Index
Fetch the complete documentation index at: https://appstleinc-aeca3e0a.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
API Key for authentication
The unique identifier of the subscription contract
x >= 1The unique identifier of the line item in the subscription contract. Must be in full GraphQL ID format
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:
x >= 1The 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
255Selling plan updated successfully
ACTIVE, PAUSED, CANCELLED, EXPIRED, FAILED, $UNKNOWN Show child attributes
SUCCEEDED, FAILED, $UNKNOWN Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
curl --request PUT \
--url https://subscription-admin.appstle.com/api/external/v2/subscription-contracts-update-line-item-selling-plan \
--header 'X-API-Key: <x-api-key>'{
"id": "gid://shopify/SubscriptionContract/123456789",
"status": "ACTIVE",
"nextBillingDate": "2024-04-01T00:00:00Z",
"customer": {
"id": "gid://shopify/Customer/987654321",
"email": "customer@example.com"
},
"lines": {
"edges": [
{
"node": {
"id": "gid://shopify/SubscriptionLine/987654321",
"quantity": 2,
"variantId": "gid://shopify/ProductVariant/42549172011164",
"title": "Premium Coffee - Dark Roast",
"currentPrice": {
"amount": "27.99",
"currencyCode": "USD"
},
"sellingPlanId": "gid://shopify/SellingPlan/56789",
"sellingPlanName": "Deliver every month",
"pricingPolicy": {
"basePrice": {
"amount": "29.99",
"currencyCode": "USD"
},
"cycleDiscounts": [
{
"afterCycle": 0,
"adjustmentType": "PERCENTAGE",
"adjustmentValue": {
"percentage": 10
}
}
]
}
}
}
]
},
"deliveryPolicy": {
"interval": "MONTH",
"intervalCount": 1
}
}