KintsugiKintsugi

Create product configurations in bulk

POST/products/configs/bulk

Create several product tax-category overrides for the resolved organization in one call. All entries succeed together, or none do: if any entry's category/subcategory does not resolve to a supported product tax code, or two entries (or an entry and an existing configuration) resolve to the same one, the whole request returns 400 or 409 and nothing is created. At most one entry across the whole request may set isDefault. Send the target organization as Organization-Id when your credential owns more than one.

Authorization

Api-KeystringRequired

Your secret API key. Include it with every request.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-07-21.

Organization-Idstring

Target organization id (Organization-Id selector).

Connection-Idstring

Target connection id; resolves to its organization.

Entity-Idstring

Platform entity id; resolves to a connection's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Body

productConfigsProductConfigCreate[]Required

The configurations to create. All succeed together, or none do.

Response

idstringRequired

The unique identifier of this configuration.

organizationIdstringRequired

The organization this configuration belongs to.

primaryProductCategoryPublicProductCategoryEnumRequired

Top-level tax category derived from primaryProductCodeName. null only if the stored code no longer resolves to a published category.

Available options:DigitalMiscPhysicalServices
primaryProductSubcategorystringRequired

Tax subcategory display label derived from primaryProductCodeName. null only if the stored code no longer resolves to a published subcategory.

primaryProductCodeNamestringRequired

The resolved product tax code this configuration applies. null only for a config predating this field's backfill, which has not yet been reclassified.

aiEnabledbooleanRequired

Whether the classifier may choose among tax codes under this configuration's category rather than always applying one fixed code.

productDescriptionstringRequired

Free-text note about this configuration. Empty when not set.

isDefaultbooleanRequired

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.

201

Successful Response

400

The request was invalid.

401

Authentication failed or was missing.

403

The credential is not permitted for this request.

404

The requested resource was not found.

409

The request conflicts with existing state.

422

The request failed validation.

cURL
POST /products/configs/bulk
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
{
"productConfigs": [
{
"primaryProductCategory": "Digital",
"primaryProductSubcategory": "General Clothing",
"aiEnabled": false,
"productDescription": "Annual software subscription",
"isDefault": false
}
]
}
Response
[
{
"id": "pcnf_2mNpQr7Ls8f3k",
"organizationId": "orgn_12345",
"primaryProductCategory": "Digital",
"primaryProductSubcategory": "General Clothing",
"primaryProductCodeName": "Acme Corp",
"aiEnabled": false,
"productDescription": "Annual software subscription",
"isDefault": false
}
]
Create product configurations in bulk (2026-07-21) | Kintsugi API Reference