---
title: >-
  tax_summaries/create webhook and taxSummaryCreate mutation now available -
  Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/posts/taxsummariescreate-webhook-and-taxsummarycreate-mutation-now-available
  md: >-
    https://shopify.dev/changelog/posts/taxsummariescreate-webhook-and-taxsummarycreate-mutation-now-available.md
metadata:
  effectiveApiVersion: 2026-01
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
    - displayName: Events & webhooks
      handle: webhook
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2025-11-03T17:25:36-05:00'
  postedAt: '2025-11-05T11:00:00-05:00'
  updatedAt: '2025-11-04T15:20:16-05:00'
  effectiveAt: '2025-11-04T03:00:00-05:00'
---

November 5, 2025

# tax\_summaries/create webhook and taxSummaryCreate mutation now available

DateNovember 5, 2025

Version[2026-01](https://shopify.dev/changelog?api_version=2026-01)

FlagsUpdate

SurfacesAPI

Affected APIs[Admin GraphQL API](https://shopify.dev/changelog?api_type=admin-graphql)[Events & webhooks](https://shopify.dev/changelog?api_type=webhook)

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:

```graphql
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](https://shopify.dev/docs/apps/build/tax).