Create a Tax Category
Creates a new tax category and attaches the supplied tax rates to it.
Operation
| Operation | Type | Purpose |
|---|---|---|
createAdminSettingsTaxCategory(input:) | Mutation | Create a tax category and attach tax rates |
Input
| Field | Required | Meaning |
|---|---|---|
code | yes | Unique machine code for the category. |
name | yes | Display name. |
description | yes | Free-text description. |
taxrates | yes | A non-empty list of existing tax-rate ids to attach. Each id must already exist. |
taxrates is required and must be non-empty
A tax category cannot be created without at least one tax rate. Passing an empty taxrates array (or omitting it) fails with "The taxrates field is required." Discover valid tax-rate ids with the adminSettingsTaxRates query.
The mutation response returns the created category's scalar fields. The attached taxRates connection is not resolved in the mutation payload — re-query adminSettingsTaxCategory and select taxRates { edges { node { _id identifier taxRate } } } to read them back.

