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:

1. Manual Parameters: Provide title, code, and presentment title directly
2. 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

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

204

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

204

Delivery method successfully updated