Add actor field to subscription contract and billing attempt mutations
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on May 04, 2026.
This Shopify update is categorized as API, New, Admin GraphQL API, 2026-07.
What changed
We have introduced a new actor field in subscription mutations to help you track who initiated an action - whether it was the customer, the merchant, or the partner app's automated system. You can now include an actor argument when creating billing attempts or editing subscription contracts. This field accepts the following values: customer: The buyer initiated the action (e.g., clicking "pay now" in a customer portal). merchant: A merchant or their staff manually initiated the action. partner: The partner app's automated system initiated the action (e.g., scheduled billing or retry logic).
Who is affected
Apps using the affected Shopify GraphQL API surface 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 →