tax_summaries/create webhook and taxSummaryCreate mutation now available

As of the 2026-01 API version, the tax_summaries/create webhook and taxSummaryCreate mutation are available for Tax Partner Apps.

What's New

The taxSummaryCreate mutation enables apps to request the generation of tax summaries for orders. The tax_summaries/create webhook is triggered by events that may affect tax liability, such as fulfillments and refunds.

Using the Mutation

The mutation accepts either a specific order ID or a time range for bulk processing:

mutation {
  taxSummaryCreate(orderId: "gid://shopify/Order/123456789") {
    enqueuedOrders {
      id
    }
    userErrors {
      field
      message
    }
  }
}

Webhook Payload

The tax_summaries/create webhook provides comprehensive tax data, including:

• Sales agreements and associated sales details
• Delivery groups with fulfillment information
• Tax exemption details
• Return sales types for refund workflows
• Order context and financial status

Requirements

• Access Scope: write_taxes
• Tax Platform Access: Tax Platform features

Learn More

For information about the Tax Platform and partnership opportunities, see Building tax apps.