KintsugiKintsugi

Categorize and approve products

POST/products/categorize-approve

Assign a productCategory/productSubcategory to the named products AND set them APPROVED, in one call. Unlike bulk-approve (which only moves partially-approved products), this classifies and signs off any products you name, at most 100. Every id must belong to the resolved organization; an id that does not exist or is in an organization you cannot access returns 404 and nothing is changed. The category/subcategory pair must resolve to a product tax code or the request returns 400. 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

productIdsstring[]Required

Products to categorize and approve (at most 100). Every id must belong to the resolved organization; an unknown id returns 404 and nothing is changed.

productCategoryPublicProductCategoryEnumRequired

Tax category to assign to every product.

Available options:DigitalMiscPhysicalServices
productSubcategorystringRequired

Tax subcategory display label to assign (e.g. 'General Clothing'). Together with productCategory it must resolve to a product tax code; an unrecognized pair returns 400.

Response

updatedCountintegerRequired

Number of products that were assigned the category/subcategory and moved to APPROVED. Equals the number of distinct ids you sent.

200

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.

422

The request failed validation.

cURL
POST /products/categorize-approve
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
{
"productIds": [
"prod_1",
"prod_2"
],
"productCategory": "Digital",
"productSubcategory": "General Clothing"
}
Response
{
"updatedCount": 2
}
Categorize and approve products (2026-07-21) | Kintsugi API Reference