KintsugiKintsugi
API reference / Disconnect a quickbooks connection

Disconnect a quickbooks connection

POST/connections/quickbooks/disconnect

Archive the QuickBooks connection matching realmId and its transactions; products and customers are archived on a best-effort basis. Searched across every organization your credential owns; narrow it to one with an Organization-Id, Connection-Id or Entity-Id selector. Returns 404 if no active QuickBooks connection matches realmId in an organization your credential can reach. Returns 409 if realmId matches more than one connection your credential can access; narrow it with a selector.

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

Narrow the request to one organization (Organization-Id selector).

Connection-Idstring

Narrow the request to a connection's organization.

Entity-Idstring

Narrow the request to a platform entity's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Body

realmIdstringRequired

QuickBooks realm id (company id) to disconnect.

Response

productsArchivedbooleanRequired

Whether the connection's products were archived. false means a best-effort step failed and this route should be retried.

customersArchivedbooleanRequired

Whether the connection's customers were archived. false means a best-effort step failed and this route should be retried.

200

Successful Response

400

The request was invalid.

401

Authentication failed or was missing.

404

The requested resource was not found.

409

The request conflicts with existing state.

422

The request failed validation.

cURL
POST /connections/quickbooks/disconnect
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
{
"realmId": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10"
}
Response
{
"productsArchived": false,
"customersArchived": false
}
Disconnect a quickbooks connection (2026-07-21) | Kintsugi API Reference