Create a product configuration
Create a product tax-category override for the resolved organization. primaryProductCategory and primaryProductSubcategory must resolve to a supported product tax code, or the request returns 400. At most one configuration per organization may set isDefault; creating a new default clears the previous one. Returns 409 if a configuration or blocklist entry already exists for the resolved tax code. Send the target organization as Organization-Id when your credential owns more than one.
Authorization
Headers
Release date, as YYYY-MM-DD. Defaults to 2026-07-21.
Target organization id (Organization-Id selector).
Target connection id; resolves to its organization.
Platform entity id; resolves to a connection's organization.
Optional source to disambiguate an Entity-Id.
Body
Top-level tax category. Must resolve to a supported tax code together with primaryProductSubcategory.
DigitalMiscPhysicalServicesTax subcategory display label, e.g. from GET /products/categories.
Let the classifier choose among tax codes under this category rather than always applying the one resolved code.
Free-text note about this configuration.
Make this the organization's default configuration. Creating a new default clears the previous one.
Response
The unique identifier of this configuration.
The organization this configuration belongs to.
Top-level tax category derived from primaryProductCodeName. null only if the stored code no longer resolves to a published category.
DigitalMiscPhysicalServicesTax subcategory display label derived from primaryProductCodeName. null only if the stored code no longer resolves to a published subcategory.
The resolved product tax code this configuration applies. null only for a config predating this field's backfill, which has not yet been reclassified.
Whether the classifier may choose among tax codes under this configuration's category rather than always applying one fixed code.
Free-text note about this configuration. Empty when not set.
Whether this is the organization's default configuration, applied when no other configuration matches a product. At most one configuration per organization may be the default.
Successful Response
The request was invalid.
Authentication failed or was missing.
The credential is not permitted for this request.
The requested resource was not found.
The request conflicts with existing state.
The request failed validation.