# Connect a stripe account through the stripe app

> POST /connections/stripe/app-connect

Source: https://docs.trykintsugi.com/reference/2026-07-21/connect-a-stripe-account-through-the-stripe-app

POST /connections/stripe/app-connect

Connect a stripe account through the stripe app

Create a Stripe connection captured through the Stripe App's OAuth installation flow. Returns 400 if the session is missing or expired. A multi-org credential must send an `Organization-Id`, `Connection-Id` or `Entity-Id` selector, or gets a 400.

Category: Connections

Request body:
accountId (string, required) - Stripe account id captured by the Stripe App installation.
mode (PublicStripeAppModeEnum, required) - Stripe environment the app was installed against.
  allowed values: TEST, LIVE, SANDBOX

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 58 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.
createdAt (string, required) - When the connection was created.
updatedAt (string) - When the connection was last updated.
lastSynced (string) - When this connection last completed a successful sync.
initialImportComplete (boolean) - True once the initial historical import has finished.
recordsSynced (integer) - Approximate count of records synced so far.
[truncated, see the reference page]

---

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