Enhanced Tax Tools: New Webhook and Mutation for Tax Partner Apps

Enhanced Tax Tools: New Webhook and Mutation for Tax Partner Apps

Shopify Updates: 

Overview

Starting with the 2026-01 API version, Shopify introduces the tax_summaries/create webhook and taxSummaryCreate mutation for Tax Partner Apps. These tools simplify tax workflows and enhance data accessibility.

What's New

The taxSummaryCreate mutation allows apps to request the generation of detailed tax summaries for orders. The tax_summaries/create webhook is triggered by events that could influence tax liability, such as refunds or fulfillments.

Using the Mutation

The mutation provides flexibility for processing tax summaries by accepting either an order ID or a specified time range. Example:

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

Webhook Payload Details

The tax_summaries/create webhook delivers comprehensive tax data for orders, including:

  • Sales agreements and detailed sales information
  • Delivery groups with fulfillment specifics
  • Tax exemption status and details
  • Return sales types addressing refund workflows
  • Financial statuses and order contexts

Requirements

To access these features, ensure the following:

  • Access scope: write_taxes
  • Tax Platform activation for your app

Learn More

For additional details about building tax apps and exploring partnership opportunities, visit the Shopify Tax Platform documentation.

Back to blog