KintsugiKintsugi

Add a product code to the blocklist

POST/products/configs/blocklist

Exclude a product tax code from onboarding suggestions for the resolved organization. Idempotent: blocklisting an already-blocklisted code returns 200 with the existing entry rather than an error or a second 201. Returns 400 if productCodeName is not a recognized product tax code, and 409 if it already has a configuration (remove the configuration first). 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

productCodeNamestringRequired

The product tax code to exclude from onboarding suggestions.

Response

idstringRequired

The unique identifier of this blocklist entry.

organizationIdstringRequired

The organization this blocklist entry belongs to.

productCodeNamestringRequired

The blocklisted product tax code.

200

The code was already blocklisted; no new entry was created. The existing entry is returned unchanged.

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/blocklist
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
{
"productCodeName": "Acme Corp"
}
Response
{
"id": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"organizationId": "orgn_12345",
"productCodeName": "Acme Corp"
}
Add a product code to the blocklist (2026-07-21) | Kintsugi API Reference