# Update a connection's settings

> PATCH /connections/{conn_id}/settings

Source: https://docs.trykintsugi.com/reference/2026-07-21/update-a-connection-s-settings

PATCH /connections/{conn_id}/settings

Update a connection's 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.

Category: Connections

Path parameters:
conn_id (string, required) - The unique identifier of the connection.

Request body:
defaultCountry (string) - Default tax country to set, as an ISO 3166-1 alpha-2 code.
netsuiteSyncMode (PublicNetsuiteSyncModeEnum) - Which NetSuite transaction types to sync. Only valid for a NetSuite connection.
  allowed values: INVOICE_ONLY, SALES_ORDER_ONLY, SALES_ORDER_AND_INVOICE, CASH_SALE_ONLY, INVOICE_AND_CASH_SALE, ALL
airwallexHistoricalSyncStartDate (string) - Import floor to set for this Airwallex connection, as YYYY-MM-DD. Only valid for an Airwallex connection; must not be a future date.
woocommerceHistoricalSyncStartDate (string) - Import floor to set for this WooCommerce connection, as YYYY-MM-DD. Only valid for a WooCommerce connection; must not be a future date.
netsuiteHistoricalSyncStartDate (string) - Import floor to set for this NetSuite connection, as YYYY-MM-DD. Only valid for a NetSuite connection; must not be a future date.
microsoftD365HistoricalSyncStartDate (string) - 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.
amazonHistoricalSyncStartDate (string) - Import floor to set for this Amazon connection, as YYYY-MM-DD. Only valid for an Amazon connection; must not be a future date.
netsuiteAccountId (string) - NetSuite account id to set. Only valid for a NetSuite connection. An empty string clears a previously stored id.
[truncated, see the reference page]

---

Index of every page: https://docs.trykintsugi.com/llms.txt