Tax summary webhook now includes merchant business entity information
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on April 01, 2026.
This Shopify update is categorized as API, New, Admin GraphQL API, Events & webhooks, 2026-04.
What changed
As of API version 2026-04, the tax_summaries/create webhook sent to Tax Partner Apps includes merchant business entity information. This identifies the business entity responsible for the transactions represented by the tax summary. What's new The tax webhook payload now features a new merchant_business_entity field at the root level of the tax summary. This field includes the following details: id: The business entity Global ID, in the format gid://shopify/BusinessEntity/{id} company_name: The legal name of the business entity display_name: The display name of the business entity address: The business entity's address, including: country province Address lines (address1, address2) city zip company The field is present only when the merchant has configured a business entity for the shop.
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 →