Retrieves the configuration settings for subscription bundles (also known as Build-a-Box or customizable subscription boxes). This endpoint returns all settings that control how customers can create and manage their custom subscription bundles.
What are Subscription Bundles (Build-a-Box)? Subscription bundles allow customers to create personalized subscription boxes by selecting multiple products from a curated collection. Instead of subscribing to a fixed product, customers build their own custom bundle that gets delivered on a recurring basis. This is perfect for coffee subscriptions, snack boxes, beauty boxes, supplement packs, and any product category where variety and personalization drive customer satisfaction.
Bundle Configuration Settings:
1. Product Selection Rules:
2. Bundle Behavior:
3. Pricing & Discounts:
4. UI/UX Settings:
5. Fulfillment Options:
6. Customer Experience:
Common Bundle Types:
Coffee Subscription Bundle:
Snack Box Bundle:
Beauty Box Bundle:
Vitamin/Supplement Bundle:
Use Cases:
Important Notes:
Best Practices:
Authentication: Requires valid X-API-Key header
curl --request GET \
--url https://subscription-admin.appstle.com/api/external/v2/subscription-bundle-settings/{id}{
"id": 12345,
"shop": "example-shop.myshopify.com",
"enabled": true,
"minProducts": 3,
"maxProducts": 8,
"minBundleValue": 40,
"maxBundleValue": 100,
"pricingModel": "FIXED_PRICE",
"fixedBundlePrice": 59.99,
"allowModifications": true,
"modificationCutoffDays": 5,
"lockAfterFirstOrder": false,
"enableProductRotation": true,
"maxSwapsPerCycle": 2,
"requireCategoryDiversity": true,
"categoryLimits": {
"coffee-light-roast": {
"min": 0,
"max": 3
},
"coffee-medium-roast": {
"min": 0,
"max": 3
},
"coffee-dark-roast": {
"min": 0,
"max": 3
},
"coffee-decaf": {
"min": 0,
"max": 2
},
"coffee-flavored": {
"min": 0,
"max": 2
}
},
"displaySettings": {
"layoutType": "GRID",
"productsPerRow": 3,
"showProductImages": true,
"showProductDescriptions": true,
"showPricing": false,
"enableFiltering": true,
"enableSearch": true,
"showBundlePreview": true
},
"notifications": {
"sendBundleCreatedEmail": true,
"sendModificationReminderEmail": true,
"reminderDaysBeforeOrder": 7,
"sendBundleModifiedConfirmation": true
},
"substitution": {
"allowSubstitutions": true,
"substitutionMethod": "SIMILAR_PRODUCT",
"notifyCustomerOfSubstitutions": true,
"allowCustomerToApproveSubstitutions": false
},
"recommendations": {
"enableRecommendations": true,
"recommendationStrategy": "POPULAR_AND_PERSONALIZED",
"showBestSellers": true,
"showCuratedBundles": true
},
"discounts": {
"enableVolumeDiscounts": true,
"volumeDiscountTiers": [
{
"minProducts": 5,
"discountPercent": 10
},
{
"minProducts": 7,
"discountPercent": 15
}
]
},
"createdAt": "2024-01-15T10:30:00Z",
"updatedAt": "2024-02-20T14:45:00Z"
}Documentation Index
Fetch the complete documentation index at: https://developers.appstle.com/llms.txt
Use this file to discover all available pages before exploring further.
API Key (Deprecated - Use Header X-API-Key instead)
Bundle settings successfully retrieved
CART, CHECKOUT, CUSTOM DEFAULT, MAX_QUANTITY, STOP_AUTO_OPEN, MIN_AMOUNT Show child attributes
curl --request GET \
--url https://subscription-admin.appstle.com/api/external/v2/subscription-bundle-settings/{id}{
"id": 12345,
"shop": "example-shop.myshopify.com",
"enabled": true,
"minProducts": 3,
"maxProducts": 8,
"minBundleValue": 40,
"maxBundleValue": 100,
"pricingModel": "FIXED_PRICE",
"fixedBundlePrice": 59.99,
"allowModifications": true,
"modificationCutoffDays": 5,
"lockAfterFirstOrder": false,
"enableProductRotation": true,
"maxSwapsPerCycle": 2,
"requireCategoryDiversity": true,
"categoryLimits": {
"coffee-light-roast": {
"min": 0,
"max": 3
},
"coffee-medium-roast": {
"min": 0,
"max": 3
},
"coffee-dark-roast": {
"min": 0,
"max": 3
},
"coffee-decaf": {
"min": 0,
"max": 2
},
"coffee-flavored": {
"min": 0,
"max": 2
}
},
"displaySettings": {
"layoutType": "GRID",
"productsPerRow": 3,
"showProductImages": true,
"showProductDescriptions": true,
"showPricing": false,
"enableFiltering": true,
"enableSearch": true,
"showBundlePreview": true
},
"notifications": {
"sendBundleCreatedEmail": true,
"sendModificationReminderEmail": true,
"reminderDaysBeforeOrder": 7,
"sendBundleModifiedConfirmation": true
},
"substitution": {
"allowSubstitutions": true,
"substitutionMethod": "SIMILAR_PRODUCT",
"notifyCustomerOfSubstitutions": true,
"allowCustomerToApproveSubstitutions": false
},
"recommendations": {
"enableRecommendations": true,
"recommendationStrategy": "POPULAR_AND_PERSONALIZED",
"showBestSellers": true,
"showCuratedBundles": true
},
"discounts": {
"enableVolumeDiscounts": true,
"volumeDiscountTiers": [
{
"minProducts": 5,
"discountPercent": 10
},
{
"minProducts": 7,
"discountPercent": 15
}
]
},
"createdAt": "2024-01-15T10:30:00Z",
"updatedAt": "2024-02-20T14:45:00Z"
}