KintsugiKintsugi

Update organization settings

PATCH/organization-settings

Updates the writable settings. Any subset of fields may be sent; absent fields are unchanged. autoFile / autoRegister require existing organization details. Admin or Owner only: returns 403 if your credential may read the organization but is not permitted to change its settings.

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

enableEuRegistrationboolean

Whether EU / OSS registration is enabled. Absent means no change.

preferCollectedTaxAmountsboolean

Whether filings prefer collected tax amounts. Absent means no change.

useSourceProductTaxExemptboolean

Whether sync respects the source product tax-exempt flag. Absent means no change.

allowProductUpdatesboolean

Whether integration-driven product updates are applied. Absent means no change.

allowAddressUpdatesboolean

Whether integration-driven address updates are applied. Absent means no change.

enableBusinessAddressFallbackboolean

Whether the business address is used as an address fallback. Absent means no change.

autoFileboolean

Whether eligible filings are submitted automatically. Absent means no change.

autoRegisterboolean

Whether registrations are opened automatically. Absent means no change.

requestIdstring

Optional client-minted id for this confirm attempt. When present, duplicate submits of the same gesture can be grouped.

Response

enableEuRegistrationbooleanRequired

Whether EU / OSS registration is enabled for the organization.

preferCollectedTaxAmountsbooleanRequired

Whether filings prefer tax amounts collected at the source over Kintsugi-calculated amounts.

useSourceProductTaxExemptbooleanRequired

Whether sync respects the source system's product tax-exempt flag instead of Kintsugi classification.

allowProductUpdatesbooleanRequired

Whether integration-driven product updates are applied.

allowAddressUpdatesbooleanRequired

Whether integration-driven transaction address updates are applied.

enableBusinessAddressFallbackbooleanRequired

Whether the business address is used as a fallback when a transaction has no ship-to or bill-to address.

autoFilebooleanRequired

Whether eligible filings are submitted automatically.

autoRegisterbooleanRequired

Whether registrations are opened automatically when nexus is reached.

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
PATCH /organization-settings
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
{
"enableEuRegistration": true,
"preferCollectedTaxAmounts": true,
"useSourceProductTaxExempt": true,
"allowProductUpdates": false,
"allowAddressUpdates": false,
"enableBusinessAddressFallback": true,
"autoFile": true,
"autoRegister": true,
"requestId": "req_2mNpQr7Ls8f3k"
}
Response
{
"enableEuRegistration": true,
"preferCollectedTaxAmounts": true,
"useSourceProductTaxExempt": true,
"allowProductUpdates": false,
"allowAddressUpdates": false,
"enableBusinessAddressFallback": true,
"autoFile": true,
"autoRegister": true
}
Update organization settings (2026-07-21) | Kintsugi API Reference