Create a tax code
Creates a new tax classification code. code MUST be unique per
entity. When AvaTax is the active jurisdiction provider, populate
avatax_tax_code to mirror the canonical AvaTax code. Requires the
tax_codes:write scope.
Authorizations
API key issued per entity via Settings > Developers > API Keys.
Each key carries scopes (e.g. orders:read, products:write).
Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.
Headers
Client-generated unique key for idempotent POST/PATCH/DELETE operations. Alias for the Idempotency parameter. Max 255 chars. On retry with the same key, the original response is returned without re-executing the operation. Keys expire after 24 hours.
255Body
Response
Tax code created
A tax classification code for products (e.g. AvaTax P0000000 generic tangible, ND040000 non-taxable digital, etc.). When AvaTax is the active jurisdiction provider, avatax_tax_code mirrors the canonical AvaTax tax code so jurisdiction sourcing flows through. Soft-delete refuses with HTTP 409 if any product still references the code (FK guard against orphaned product tax classification). Scope: tax_codes:read / tax_codes:write / tax_codes:delete.
"tax_code"
Operator-defined code unique per entity. 1..50 chars.
Human-readable label. 1..150 chars.
If false, products with this code are exempt from sales tax.
Optional grouping label (e.g. 'general', 'food', 'digital').
Mirrors the AvaTax tax code when AvaTax is the active provider.
Free-form caller metadata. Default {}.

