tax_summaries/create webhook and taxSummaryCreate mutation now available

Shopify Updates: 

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.

Back to blog