KintsugiKintsugi

Enable tax collection on a connection

POST/connections/{conn_id}/enable-tax-collection

Enable tax calculation (L2) on a connection. A no-op that returns the connection's settings unchanged if it is already enabled. Returns 400 if the connection is not ready for tax calculation or has opted out of tax collection. Returns 403 if the connection is an Ordway connection your credential is not permitted to enable L2 on. Returns 404 if the connection does not exist or belongs to an organization your credential cannot access. A multi-org credential must send an Organization-Id, Connection-Id or Entity-Id selector, or gets a 400. Returns 503 if a per-connector tax-provisioning call fails; retrying may succeed.

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.

Path parameters

conn_idstringRequired

The unique identifier of the connection.

Response

idstringRequired

Kintsugi's unique identifier for the connection.

taxCollectionEnabledbooleanRequired

Whether tax calculation is enabled on this connection.

defaultCountrystring

Default tax country for this connection (ISO 3166-1 alpha-2); null when unset.

netsuiteSyncModePublicNetsuiteSyncModeEnum

Which NetSuite transaction types this connection syncs. null for every non-NetSuite connection.

Available options:INVOICE_ONLYSALES_ORDER_ONLYSALES_ORDER_AND_INVOICECASH_SALE_ONLYINVOICE_AND_CASH_SALEALL
airwallexHistoricalSyncStartDatestring

Import floor for this Airwallex connection, as YYYY-MM-DD. null for every non-Airwallex connection, or when unset.

woocommerceHistoricalSyncStartDatestring

Import floor for this WooCommerce connection, as YYYY-MM-DD. null for every non-WooCommerce connection, or when unset.

netsuiteHistoricalSyncStartDatestring

Import floor for this NetSuite connection, as YYYY-MM-DD. null for every non-NetSuite connection, or when unset.

microsoftD365HistoricalSyncStartDatestring

Import floor for this Microsoft Dynamics 365 connection, as YYYY-MM-DD. null for every non-D365 connection, or when unset.

amazonHistoricalSyncStartDatestring

Import floor for this Amazon connection, as YYYY-MM-DD. null for every non-Amazon connection, or when unset.

netsuiteAccountIdstring

NetSuite account id captured from Vault on (re)connect. null for every non-NetSuite connection, or when unset.

netsuiteSubsidiaryIdstring

NetSuite subsidiary id captured from Vault on (re)connect. null for every non-NetSuite connection, or when unset.

isOneworldAccountboolean

Whether this NetSuite account is a OneWorld (multi-subsidiary) account. null for every non-NetSuite connection, or when unset.

dualentryCompanyIdstring

DualEntry platform company id this connection is scoped to. null for every non-DualEntry connection, when scoped to every company, or when unset.

apideckConnectionStatestring

Apideck Vault connection state (e.g. callable, authorized) for an Apideck-backed connection. null when unset.

needsUpdateboolean

Whether this connection needs re-authorization or another manual fix before it can sync.

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.

503

A service this request depends on was unavailable. Retry the request.

cURL
POST /connections/{conn_id}/enable-tax-collection
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/connections/{conn_id}/enable-tax-collection
Response
{
"id": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"taxCollectionEnabled": false,
"defaultCountry": "US",
"netsuiteSyncMode": "INVOICE_ONLY",
"airwallexHistoricalSyncStartDate": "2026-07-21",
"woocommerceHistoricalSyncStartDate": "2026-07-21",
"netsuiteHistoricalSyncStartDate": "2026-07-21",
"microsoftD365HistoricalSyncStartDate": "2026-07-21",
"amazonHistoricalSyncStartDate": "2026-07-21",
"netsuiteAccountId": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"netsuiteSubsidiaryId": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"isOneworldAccount": false,
"dualentryCompanyId": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"apideckConnectionState": "apideck connection state",
"needsUpdate": false
}
Enable tax collection on a connection (2026-07-21) | Kintsugi API Reference