# Opt a connection out of tax collection

> POST /connections/{conn_id}/opt-out-tax-collection

Source: https://docs.trykintsugi.com/reference/2026-10-06/opt-a-connection-out-of-tax-collection

POST /connections/{conn_id}/opt-out-tax-collection

Opt a connection out of tax collection

Record that the customer chose not to enable tax collection on a connection. Opting out blocks tax collection on the connection. Until support clears the opt-out, enabling tax collection on the connection returns 400. Opting out again returns the connection unchanged. Returns 400 if tax collection is already enabled on the connection or its source does not support opting out. 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. The optional body takes `requestId`.

Category: Connections

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

Request body:
requestId (string) - Optional client-generated id for this attempt (a UUID or a short slug), stored on the audit trail so a later read can tell repeated attempts apart.

Response fields:
id (string, required) - Kintsugi's unique identifier for the connection.
organizationId (string, required) - Id of the organization this connection belongs to.
platformEntityId (string) - The platform's own identifier for the entity this connection points at (e.g. a QuickBooks realm id, D365 company id, NetSuite subsidiary id). Use it to resolve a connection from an id you already hold. `null` until captured on (re)connect or backfilled.
externalId (string, required) - The connection's own external identifier: an Apideck consumer id for a Vault-backed source, or the platform-specific value the connector stores (e.g. a Shopify shop id, a Stripe publishable key).
source (string, required) - Origin platform of the connection (e.g. SHOPIFY, QUICKBOOKS). Any origin outside the published values is reported as OTHER.
  allowed values: ACUMATICA, AIRWALLEX, AMAZON, API, APPLE_APP_STORE, BESTBUY, BIGCOMMERCE, BILL_COM, BUNNY, CAMPFIRE, CHARGEBEE, CHECKOUTCHAMP (and 59 more, see the reference page)
status (PublicConnectionStatusEnum, required) - Lifecycle status of the connection.
  allowed values: ACTIVE, INACTIVE, CONNECTION_ERROR
storeName (string) - Human-readable store or account name for the connection; an empty string when the connection has none.
url (string) - Public shop/account URL when the source exposes one; not a secret.
[truncated, see the reference page]

---

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