Bulk update subscription delivery price

Updates the delivery price for subscription contracts in bulk.

Full behavior, validation rules, and side effects

Endpoint: PUT /api/external/v2/bulk-automations/delivery-price

Authentication:

• API Key (query parameter: api_key) Query Parameters:
• api_key (required) – Your API key
• deliveryPrice (required) – New delivery price to be applied
• allSubscriptions (optional) – Apply to all subscriptions for the shop (true/false)

Request Body:

{
  "subscriptionIds": "28191031580"
}

What This Endpoint Does:

• Updates the delivery price for provided subscription contracts
• Creates a bulk automation task
• Processes updates asynchronously in the background using AWS Step Functions

How It Works:

1. Merchant provides new delivery price via query parameter
2. Subscription IDs are provided as a comma-separated string in the request body (ignored if allSubscriptions=true)
3. System validates shop ownership and ensures no bulk job is currently running
4. Bulk automation job is created
5. Delivery price is updated for each subscription asynchronously

Important Notes:

• Only one bulk automation per shop can run at a time
• Processing is asynchronous
• Previously generated orders are not modified
• If allSubscriptions=true, provided subscriptionIds will be ignored
• If allSubscriptions=false, subscriptionIds cannot be empty

PUT /api/external/v2/bulk-automations/delivery-price

Bulk update subscription delivery price

cURL

curl --request PUT \
  --url https://subscription-admin.appstle.com/api/external/v2/bulk-automations/delivery-price \
  --header 'Content-Type: application/json' \
  --data '
{
  "subscriptionIds": "<string>"
}
'

204

{}

Query Parameters

api_key · string · required

Your API Key

deliveryPrice · number<double> · required

suppressEmailNotification · boolean

allSubscriptions · boolean

Body

application/json

subscriptionIds · string

Response

204

application/json

Bulk delivery price update successfully queued and initiated.