Manage tax classes programmatically with the new Tax Classes API

Manage tax classes programmatically with the new Tax Classes API

Key highlights

A new v3 endpoint gives developers and system integrators full batch control over tax class configuration — no control panel required.

Create, update, and delete up to 50 tax classes in a single API request — no manual control panel updates needed.

Designed for automation: ideal for multi-store management, ERP integrations, and headless deployments where tax configuration must be scripted at scale.

Works in concert with the Tax Rates & Zones API, giving you full programmatic control over the entire manual tax configuration stack.

What the Tax Classes API endpoint does

Tax classes determine how different types of products are taxed. Previously, creating and managing them required manual work in the BigCommerce control panel. The new Tax Classes API (POST /v3/tax/classes) changes that.

The endpoint supports three batch operations — create, update, and delete — all on the same /tax/classes path. Each operation accepts up to 50 items per request and returns structured JSON responses in BigCommerce's standard envelope format. Deletes are filter-based, using the id:in query parameter rather than a request body.

API reference documentation for Tax Classes API can be viewed here.

Why this matters

For merchants running complex catalogs — especially those with physical goods, digital products, and services selling across multiple jurisdictions — keeping tax classes in sync with product taxonomy has always been a friction point. Until now, there was no reliable way to script it.

This endpoint unlocks tax class management as part of a repeatable, version-controlled deployment workflow. Whether you're provisioning a new store, syncing from an ERP, or managing a fleet of storefronts, you can now include tax class setup in the same pipeline as the rest of your catalog and configuration work.

Sample use cases

Multi-store provisioning — Automatically replicate a consistent set of tax classes across new storefronts at setup time, without manual configuration for each.

ERP & PIM integration — Keep tax class definitions in sync with product taxonomy changes originating in an ERP or PIM system, without human intervention.

Headless deployments — Include tax class setup as a scripted step in headless store deployment pipelines, alongside catalog, channel, and settings configuration.

Catalog restructuring — Batch-rename or consolidate tax classes when product lines change, rather than editing them one by one in the control panel.