# Product Bundles

APIs for managing subscription product bundles, bundle configurations, item grouping, and bundle-specific discount codes

## Generate bundle-specific discount code

 - [PUT /api/external/v2/subscription-bundlings/discount/{token}](https://developers.membership.appstle.com/admin-api-swagger/product-bundles/generatediscountv2.md): Creates a Shopify discount code specifically for a subscription bundle. This endpoint generates unique, single-use or multi-use discount codes tied to bundle purchases.

Key Features:
- Bundle-Specific Codes: Discounts that apply only to specific bundles
- Flexible Discount Types: Percentage off, fixed amount off, or free shipping
- Usage Limits: Single-use, limited use, or unlimited codes
- Expiration Dates: Set validity periods for promotional campaigns
- Minimum Requirements: Minimum purchase amount or quantity thresholds
- Customer Eligibility: Restrict to specific customer segments or tags

Discount Configuration:
- Code Format: Custom code or auto-generated random code
- Discount Value: Percentage (e.g., 15%) or fixed amount (e.g., $10)
- Start/End Dates: Campaign duration controls
- Usage Limit: Max number of times code can be used
- Once Per Customer: Prevent code reuse by same customer
- Bundle Association: Links discount to specific bundle token

Use Cases:
- Create promotional codes for bundle launches
- Generate unique codes for influencer campaigns
- Offer first-time subscriber discounts on bundles
- Seasonal or holiday bundle promotions
- Referral program discount codes
- Partner/affiliate exclusive bundle offers

Authentication: Requires API key authentication via X-API-Key header or api_key parameter

## Get bundle details by handle

 - [GET /api/external/v2/subscription-bundlings/external/get-bundle/{handle}](https://developers.membership.appstle.com/admin-api-swagger/product-bundles/getvalidsubscriptioncustomerv2_1.md): Retrieves detailed information about a subscription product bundle including bundled items, pricing, and subscription plan details.

Key Information Returned:
- Bundle Configuration: Name, handle, description, status
- Bundled Items: Products included in the bundle with quantities
- Pricing: Total price, individual item prices, discounts
- Subscription Details: Associated membership plan, billing frequency
- Product Information: Variant details, images, availability
- Display Settings: How the bundle should be presented to customers

Bundle Components:
- Product handles and variant IDs
- Quantity per product in the bundle
- Bundle-level discounts or pricing rules
- Subscription plan associations
- Custom attributes and metadata

Use Cases:
- Display bundle details on product pages
- Retrieve bundle configuration for cart integration
- Show customers what's included in a bundle
- Sync bundle data with external systems
- Build custom bundle selection interfaces

Authentication: Requires API key authentication via X-API-Key header or api_key parameter