Orders webhooks now include selling_plan_id on line items

Line items in Orders webhook payloads now include a selling_plan_id field. This field identifies the selling plan applied to a subscription line item, which helps you avoid extra API calls to look up that information. The change applies to API version 2026-10 and later, and you don’t need to take any action to keep your app working.

Previously, if your app needed to know which selling plan applied to a subscription line item, it had to make a follow-up Admin API call for every order it received. That value now arrives directly in the webhook payload.

In Orders webhook payloads, selling_plan_id contains the ID of the selling plan applied to the line item. It’s null for line items that aren’t part of a subscription.

{
  "line_items": [
    {
      "id": 123456789,
      "selling_plan_id": 987654321
    }
  ]
}

This example shows a line item that includes a selling_plan_id value for a subscription.

This change is available on API version 2026-10 and later. Earlier versions are unaffected, and no action is required.

For details on Orders webhook payloads, see the orders webhooks reference.