Subscription Management

Update subscription delivery method

Updates the delivery method for a subscription contract, supporting standard shipping, local delivery, and customer pickup options. The delivery method determines how future orders will be fulfilled.

Full behavior, validation rules, and side effects

Delivery Method Types: The system automatically determines the type based on the subscription’s current delivery address:

SHIPPING: Standard shipping to customer address (default)
LOCAL: Local delivery within merchant’s delivery zones
PICK_UP: Customer pickup at designated location

Two Ways to Update:

Manual Parameters: Provide title, code, and presentment title directly
Delivery Method ID: Provide a Shopify DeliveryMethodDefinition ID to auto-populate all fields

Using Delivery Method ID: When providing a delivery-method-id:

System fetches the method from Shopify’s delivery profiles
Automatically sets title, code, and presentment title
Applies associated delivery price if defined
ID can be numeric or full GraphQL ID format

Delivery Type Requirements:

Standard Shipping: No additional requirements
Local Delivery: Phone number must exist in delivery address
Pickup: Pickup location must be configured in subscription

Price Updates:

If using delivery-method-id with a fixed price, updates delivery price
Manual updates don’t change the delivery price
Price changes affect all future orders

Side Effects:

Creates activity log entry with method details
May remove invalid discount codes automatically
Updates apply to all future orders immediately
No customer notification sent

Common Use Cases:

Switch from standard shipping to express shipping
Change pickup location for customer convenience
Update local delivery options based on availability
Apply seasonal delivery methods

Important Notes:

Cannot change the delivery type (shipping/local/pickup) - only the method within that type
Delivery methods must be configured in Shopify’s shipping settings
Changes don’t affect orders already in fulfillment

Authentication: Requires valid X-API-Key header

PUT

/

api

/

external

/

v2

/

subscription-contracts-update-delivery-method

Update subscription delivery method

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

Headers

X-API-Key

string

required

API Key for authentication

Query Parameters

contractId

integer<int64>

required

Subscription contract ID to update

Required range: x >= 1

delivery-method-title

string

required

Display name of the delivery method. This is what customers see. Ignored if delivery-method-id is provided.

Maximum string length: 255

delivery-method-code

string

required

Internal code for the delivery method. Often same as title. Used for system identification. Ignored if delivery-method-id is provided.

Maximum string length: 255

delivery-method-presentment-title

string

required

Localized version of the title for multi-language stores. Often same as title for single-language stores. Ignored if delivery-method-id is provided.

Maximum string length: 255

delivery-method-id

string

Optional Shopify DeliveryMethodDefinition ID. When provided, automatically fetches and applies the delivery method's title, code, presentment title, and price. Can be numeric ID or full GraphQL ID (gid://shopify/DeliveryMethodDefinition/123).

Response

Delivery method successfully updated

Update maximum cycles for a subscription contract

Update delivery interval for a subscription contract

Update subscription delivery method

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