`BusinessEntity` now exposes `legalEntityId` in the GraphQL Admin API
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on July 01, 2026.
This Shopify update is categorized as API, New, Admin GraphQL API, 2026-07.
What changed
As of API version 2026-07, the BusinessEntity type in the GraphQL Admin API includes a new legalEntityId field. This field returns the stable Central Legal Entity ID from Shopify's Organizations Platform, giving Partners a consistent identifier for the same legal entity across multiple shops, markets, and sales channels. What's new The BusinessEntity type now includes: legalEntityId (BigInt, nullable): The stable organization-level legal entity identifier. This ID is consistent across all shops belonging to the same legal entity, enabling partners to recognize the same underlying company regardless of how many shops or markets it operates. This field returns null when the business entity has no backing Central Legal Entity or when the legal entity does not have a stable external ID.
Who is affected
Apps that subscribe to or process Shopify webhooks or event payloads should review this change.
What action may be needed
Review whether the new capability is relevant to your app. If you plan to use it, test the affected API or workflow before adopting it in production.
Use the official Shopify entry below as the source of truth for technical implementation details, affected APIs, migration instructions and deadlines.
Want the actionable version?
MerchantDiff monitors Shopify API changes, deprecations, deadlines and ecosystem updates, then turns them into developer-focused release intelligence: what changed, who is affected and what action may be needed.
Get MerchantDiff →