# Activate an apideck-backed connection

> POST /connections/apideck/{conn_id}/activate

Source: https://docs.trykintsugi.com/reference/2026-10-06/activate-an-apideck-backed-connection

POST /connections/apideck/{conn_id}/activate

Activate an apideck-backed connection

Activate an Apideck-backed connection after the Vault widget flow completes, with duplicate-connection handling by `shopId` (e.g. the QuickBooks realmId or the WooCommerce shop domain). Omit `shopId` to have the platform verify the Vault connection and resolve it automatically. If another connection already exists for the same `shopId`, that one is reactivated and this one is superseded. Returns 400 if the connection is not an Apideck-backed connection. Returns 404 if the connection does not exist, is archived, 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 the Apideck Vault call itself fails; retrying may succeed. Returns 400 with code `already_connected` when `shopId` matched a connection you already have: that connection was reactivated (and given any NetSuite or DualEntry values sent here), this one was deleted, and nothing further is needed. Send `netsuiteAccountId`, `netsuiteSubsidiaryId` or `dualentryCompanyId` here, not in a settings update beforehand, so they land on the connection that stays.

Category: Connections

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

Request body:
shopId (string) - Store/company identifier for duplicate-connection checking (e.g. the QuickBooks realmId or the WooCommerce shop domain). Omit to have the platform verify the Vault connection and resolve it automatically.
netsuiteAccountId (string) - NetSuite only: the account id from Vault. Written to the connection this activate keeps, which is the existing connection when `shopId` matches one. Omit to leave the stored value unchanged. Ignored for other sources.
netsuiteSubsidiaryId (string) - NetSuite only: the subsidiary id from Vault. Written like `netsuiteAccountId`. Omit to leave the stored value unchanged. Ignored for other sources.
dualentryCompanyId (string) - DualEntry only: the company id from Vault. Written like `netsuiteAccountId`. Omit to leave the stored value unchanged; send `null` or an empty string to scope the connection to every company. Ignored for other sources.

Response fields:
id (string, required) - Kintsugi's unique identifier for the connection.
[truncated, see the reference page]

---

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