sellingPlanGroupId parameter now available in add line endpoints
November 12th, 2025
Merchants can now specify sellingPlanGroupId when adding line items through Storefront and Admin APIs.
What's New?
The sellingPlanGroupId parameter enables merchants to define which specific selling plan discount should be applied to a line item. This provides greater control over subscription pricing and ensures the correct selling plan is associated with line items during cart and subscription operations.
The changes have been made on the following endpoints:
- Admin API
- Add line: Add line items with a specific selling plan
- Bulk line update: Update multiple line items with selling plan changes
- Swap line: Swap line items while maintaining or changing selling plans
- Storefront API
- Add line: Add line items to subscription contracts with selling plans
- Bulk update lines: Swap line items on existing subscriptions
- Swap line: Swap line items while maintaining or changing selling plans
Things to Keep in Mind
- The product variant on which the operation is being executed must be mapped to the specified selling plan group.
- The
sellingPlanGroupIdpassed must have the same frequency as the subscription contract. For example, if the subscription contract has a 3-month billing frequency, the selling plan passed must also have a 3-month frequency.
