KintsugiKintsugi

Update a connection's settings

PATCH/connections/{conn_id}/settings

Partially update per-connector settings on a connection: defaultCountry, apideckConnectionState and needsUpdate apply to any connection; every other field applies only to a connection of the matching source (NetSuite, Airwallex, WooCommerce, Microsoft Dynamics 365, Amazon, or DualEntry). Only the fields you send are changed. Returns 400 if netsuiteSyncMode selects a cash-capable mode while the NetSuite cash-sale sync beta is off for this connection. Returns 404 if the connection does not exist, belongs to an organization your credential cannot access, or a per-connector field was sent for a connection of a different source. A multi-org credential must send an Organization-Id, Connection-Id or Entity-Id selector, or gets a 400.

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.

Body

defaultCountrystring

Default tax country to set, as an ISO 3166-1 alpha-2 code.

netsuiteSyncModePublicNetsuiteSyncModeEnum

Which NetSuite transaction types to sync. Only valid for a NetSuite connection.

Available options:INVOICE_ONLYSALES_ORDER_ONLYSALES_ORDER_AND_INVOICECASH_SALE_ONLYINVOICE_AND_CASH_SALEALL
airwallexHistoricalSyncStartDatestring

Import floor to set for this Airwallex connection, as YYYY-MM-DD. Only valid for an Airwallex connection; must not be a future date.

woocommerceHistoricalSyncStartDatestring

Import floor to set for this WooCommerce connection, as YYYY-MM-DD. Only valid for a WooCommerce connection; must not be a future date.

netsuiteHistoricalSyncStartDatestring

Import floor to set for this NetSuite connection, as YYYY-MM-DD. Only valid for a NetSuite connection; must not be a future date.

microsoftD365HistoricalSyncStartDatestring

Import floor to set for this Microsoft Dynamics 365 connection, as YYYY-MM-DD. Only valid for a D365 connection; must not be a future date.

amazonHistoricalSyncStartDatestring

Import floor to set for this Amazon connection, as YYYY-MM-DD. Only valid for an Amazon connection; must not be a future date.

netsuiteAccountIdstring

NetSuite account id to set. Only valid for a NetSuite connection. An empty string clears a previously stored id.

netsuiteSubsidiaryIdstring

NetSuite subsidiary id to set. Only valid for a NetSuite connection. An empty string clears a previously stored id.

isOneworldAccountboolean

Whether this NetSuite account is a OneWorld (multi-subsidiary) account. Only valid for a NetSuite connection.

dualentryCompanyIdstring

DualEntry platform company id to scope this connection's sync to. Only valid for a DualEntry connection. An empty string clears the scope back to every company, and resets the sync cursor for company-scoped entities.

apideckConnectionStatestring

Apideck Vault connection state to record (e.g. callable, authorized). Valid for any Apideck-backed connection.

needsUpdateboolean

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

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.

cURL
PATCH /connections/{conn_id}/settings
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
{
"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
}
Example request
https://api.trykintsugi.com/connections/{conn_id}/settings
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
}
Update a connection's settings (2026-07-21) | Kintsugi API Reference