fix(webapp): don't prefill overrideAuthParams with integration defaults on connection create (#6990)

## Describe the problem and your solution

- don't prefill overrideAuthParams with integration defaults on
connection create
- Migrate bigcommerce docs to use new format.


<!-- Issue ticket number and link (if applicable) -->

<!-- Testing instructions (skip if just adding/editing providers) -->



<!-- This is an auto-generated description by cubic. -->
<a href="https://cubic.dev/pr/NangoHQ/nango/pull/6990?utm_source=github"
target="_blank" rel="noopener noreferrer"
data-no-image-dialog="true"><picture><source
media="(prefers-color-scheme: dark)"
srcset="https://www.cubic.dev/buttons/review-in-cubic-dark.svg"><source
media="(prefers-color-scheme: light)"
srcset="https://www.cubic.dev/buttons/review-in-cubic-light.svg"><img
alt="Review in cubic"
src="https://www.cubic.dev/buttons/review-in-cubic-dark.svg"></picture></a>
<!-- End of auto-generated description by cubic. -->

Author: hassan254-prog

docs/api-catalog.txt

@@ -109,7 +109,7 @@ URL patterns:
 | `beehiiv` | Beehiiv | API_KEY | [docs](https://nango.dev/docs/integrations/all/beehiiv.md) |  |  | communication, marketing |
 | `bettercontact` | BetterContact | API_KEY | [docs](https://nango.dev/docs/api-integrations/bettercontact.md) | [connect](https://nango.dev/docs/api-integrations/bettercontact/connect.md) |  | crm |
 | `bigchange` | BigChange | OAUTH2_CC | [docs](https://nango.dev/docs/api-integrations/bigchange.md) | [connect](https://nango.dev/docs/api-integrations/bigchange/connect.md) |  | productivity |
-| `bigcommerce` | BigCommerce | OAUTH2 | [docs](https://nango.dev/docs/integrations/all/bigcommerce.md) |  |  | e-commerce |
+| `bigcommerce` | BigCommerce | OAUTH2 | [docs](https://nango.dev/docs/api-integrations/bigcommerce.md) | [connect](https://nango.dev/docs/api-integrations/bigcommerce/connect.md) | [setup](https://nango.dev/docs/api-integrations/bigcommerce/how-to-register-your-own-bigcommerce-api-oauth-app.md) | e-commerce |
 | `bill` | Bill (Connect API) | BILL | [docs](https://nango.dev/docs/integrations/all/bill.md) |  |  | payment |
 | `bill-sandbox` | Bill (Connect API Sandbox) | BILL | [docs](https://nango.dev/docs/integrations/all/bill-sandbox.md) | [connect](https://nango.dev/docs/integrations/all/bill-sandbox/connect.md) |  | payment |
 | `bing-webmasters` | Bing Webmasters | OAUTH2 | [docs](https://nango.dev/docs/api-integrations/bing-webmasters.md) |  | [setup](https://nango.dev/docs/api-integrations/bing-webmasters/how-to-register-your-own-bing-webmasters-api-oauth-app.md) | dev-tools |

docs/api-integrations/bigcommerce.mdx

@@ -0,0 +1,84 @@
+---
+title: 'BigCommerce'
+sidebarTitle: 'BigCommerce'
+description: 'Integrate your application with the BigCommerce API'
+---
+
+## 🚀 Quickstart
+
+Connect to BigCommerce with Nango and see data flow in 2 minutes.
+
+<Steps>
+    <Step id="create-integration" title="Create the integration">
+    In Nango ([free signup](https://app.nango.dev)), go to [Integrations](https://app.nango.dev/dev/integrations) -> _Configure New Integration_ -> _BigCommerce_. Enter the Client ID and Client Secret from your BigCommerce app (see the setup guide below).
+    </Step>
+    <Step id="authorize-bigcommerce" title="Authorize BigCommerce">
+    Go to [Connections](https://app.nango.dev/dev/connections) -> _Add Test Connection_ -> _Authorize_, then enter the store's Store Hash (see the connect guide below for where to find it) and log in to BigCommerce to approve access. Later, you'll let your users do the same directly from your app.
+    </Step>
+    <Step id="call-bigcommerce-api" title="Call the BigCommerce API">
+    Let's make your first request to the BigCommerce API (fetch a list of orders). Replace the placeholders below with your [secret key](https://app.nango.dev/dev/environment-settings), [integration ID](https://app.nango.dev/dev/integrations), and [connection ID](https://app.nango.dev/dev/connections):
+    <Tabs>
+        <Tab title="cURL">
+
+            ```bash
+            curl "https://api.nango.dev/proxy/v2/orders" \
+              -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
+              -H "Provider-Config-Key: <INTEGRATION-ID>" \
+              -H "Connection-Id: <CONNECTION-ID>"
+            ```
+
+        </Tab>
+
+        <Tab title="Node">
+
+        Install Nango's backend SDK with `npm i @nangohq/node`. Then run:
+
+        ```typescript
+        import { Nango } from '@nangohq/node';
+
+        const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });
+
+        const res = await nango.get({
+            endpoint: '/v2/orders',
+            providerConfigKey: '<INTEGRATION-ID>',
+            connectionId: '<CONNECTION-ID>'
+        });
+
+        console.log(res.data);
+        ```
+        </Tab>
+
+    </Tabs>
+    Or fetch credentials with the [Node SDK](/reference/backend/backend-sdk/node#get-a-connection-with-credentials) or [API](/reference/backend/http-api/connection/get).
+
+    ✅ You're connected! Check the [Logs](https://app.nango.dev/dev/logs) tab in Nango to inspect requests.
+    </Step>
+
+    <Step id="implement-nango" title="Implement Nango in your app">
+        Follow our [Auth implementation guide](/guides/auth/auth-guide) to integrate Nango in your app.
+
+        To obtain your own production credentials, follow the setup guide linked below.
+    </Step>
+</Steps>
+
+## 📚 BigCommerce Integration Guides
+
+Nango maintained guides for common use cases.
+
+- [How to register your own BigCommerce OAuth app](/api-integrations/bigcommerce/how-to-register-your-own-bigcommerce-api-oauth-app)  
+Register an OAuth app with BigCommerce and obtain credentials to connect it to Nango
+
+- [How to link your BigCommerce account](/api-integrations/bigcommerce/connect)  
+Find your store's Store Hash to connect your BigCommerce account to Nango
+
+Official docs: [BigCommerce API documentation](https://docs.bigcommerce.com/developer/docs/overview/quick-start)
+
+## 🧩 Pre-built syncs & actions for BigCommerce
+
+Enable them in your dashboard. Extend and customize to fit your needs.
+
+import PreBuiltUseCases from "/snippets/generated/bigcommerce/PreBuiltUseCases.mdx"
+
+<PreBuiltUseCases />
+
+---

docs/api-integrations/bigcommerce/connect.mdx

@@ -0,0 +1,30 @@
+---
+title: BigCommerce - How do I link my account?
+sidebarTitle: BigCommerce
+---
+
+# Overview
+
+To authenticate with BigCommerce, you will need:
+1. **Store Hash** - The unique identifier for your BigCommerce store.
+
+### Prerequisites:
+
+- You must have a BigCommerce store.
+
+### Instructions:
+
+#### Step 1: Finding your Store Hash
+
+Log in to your BigCommerce account and look at your browser's address bar — your Store Hash is the part right after `store-` (e.g. `https://store-abc123.mybigcommerce.com/...` → `abc123`).
+
+#### Step 2: Enter your credentials in the Connect UI
+
+Once you have your **Store Hash**:
+1. Open the form where you need to authenticate with BigCommerce.
+2. Enter your **Store Hash** in the corresponding field.
+3. Submit the form, then log in to BigCommerce to approve access.
+
+<img src="/api-integrations/bigcommerce/form.png" style={{maxWidth: "450px" }}/>
+
+You are now connected to BigCommerce.

docs/api-integrations/bigcommerce/form.png

@@ -0,0 +1,48 @@
+---
+title: 'How to register your own BigCommerce OAuth app'
+sidebarTitle: 'BigCommerce Setup'
+description: 'Register an OAuth app with BigCommerce and connect it to Nango'
+---
+
+This guide shows you how to register your own app with BigCommerce to obtain your OAuth credentials (client ID, client secret, and account UUID). These are required to let your users grant your app access to their BigCommerce store.
+
+<Steps>
+  <Step title="Create a developer account">
+    Go to the [BigCommerce Developer Portal](https://devtools.bigcommerce.com/) and sign up for a developer account.
+  </Step>
+  <Step title="Create a new app">
+    Click **+ Create App**, then enter a name for your app. BigCommerce apps can be single-store (private, no review required) or listed on the App Marketplace, which requires going through BigCommerce's [marketplace approval process](https://docs.bigcommerce.com/developer/docs/integrations/apps/guide/approval-requirements). If you only need to connect your own store, a single-store app avoids that process entirely.
+  </Step>
+  <Step title="Copy your generated credentials">
+    Once the app is created, BigCommerce generates your **Client ID**, **Client Secret**, and **Account UUID** together. Copy all three — you'll need them when configuring the BigCommerce integration in Nango.
+
+    <Note>The Account UUID belongs to your developer app, not to any single merchant's store. It's the same value for every connection made through this integration — see the last step below for how to apply it automatically without asking each user for it.</Note>
+  </Step>
+  <Step title="Configure the callback URL">
+    In your app's **App Information** tab, set the auth callback URL to `https://api.nango.dev/oauth/callback`. Then, in the **Scopes** tab, select the OAuth scopes your integration needs — these should match the ones you select in Nango.
+  </Step>
+  <Step title="Apply the Account UUID to every connection">
+    Since the Account UUID is fixed for your app, set it once as a [connection config default](/reference/backend/http-api/connect/sessions/create) instead of collecting it from each user. Pass it under `integrations_config_defaults` when creating a connect session:
+
+    ```json
+    {
+        "integrations_config_defaults": {
+            "<INTEGRATION-ID>": {
+                "connection_config": {
+                    "accountUuid": "<YOUR-ACCOUNT-UUID>"
+                }
+            }
+        }
+    }
+    ```
+
+    Every connection created from that session will use this value automatically — your users only need to provide their **Store Hash** (see [how to link a BigCommerce account](/api-integrations/bigcommerce/connect)).
+  </Step>
+  <Step title="Next">
+    Follow the [_Quickstart_](/getting-started/quickstart) to connect your first account.
+  </Step>
+</Steps>
+
+For more details, see [BigCommerce's OAuth documentation](https://docs.bigcommerce.com/developer/docs/integrations/apps/guide/auth).
+
+---

docs/api-integrations/bigcommerce/how-to-register-your-own-bigcommerce-api-oauth-app.mdx

@@ -110,6 +110,10 @@
       "source": "/integrations/all/servicenow",
       "destination": "/api-integrations/servicenow"
     },
+    {
+      "source": "/integrations/all/bigcommerce",
+      "destination": "/api-integrations/bigcommerce"
+    },
     {
       "source": "/introduction",
       "destination": "/"
@@ -1040,7 +1044,7 @@
               "api-integrations/bettercontact",
               "api-integrations/bigchange",
               "api-integrations/bliro",
-              "integrations/all/bigcommerce",
+              "api-integrations/bigcommerce",
               "integrations/all/bill",
               "integrations/all/bill-sandbox",
               "integrations/all/bitbucket",

docs/docs.json

@@ -14750,7 +14750,7 @@ Use these slugs to construct provider-specific docs URLs only when needed.
 | `beehiiv` | Beehiiv | API_KEY | [docs](https://nango.dev/docs/integrations/all/beehiiv.md) |  |  | communication, marketing |
 | `bettercontact` | BetterContact | API_KEY | [docs](https://nango.dev/docs/api-integrations/bettercontact.md) | [connect](https://nango.dev/docs/api-integrations/bettercontact/connect.md) |  | crm |
 | `bigchange` | BigChange | OAUTH2_CC | [docs](https://nango.dev/docs/api-integrations/bigchange.md) | [connect](https://nango.dev/docs/api-integrations/bigchange/connect.md) |  | productivity |
-| `bigcommerce` | BigCommerce | OAUTH2 | [docs](https://nango.dev/docs/integrations/all/bigcommerce.md) |  |  | e-commerce |
+| `bigcommerce` | BigCommerce | OAUTH2 | [docs](https://nango.dev/docs/api-integrations/bigcommerce.md) | [connect](https://nango.dev/docs/api-integrations/bigcommerce/connect.md) | [setup](https://nango.dev/docs/api-integrations/bigcommerce/how-to-register-your-own-bigcommerce-api-oauth-app.md) | e-commerce |
 | `bill` | Bill (Connect API) | BILL | [docs](https://nango.dev/docs/integrations/all/bill.md) |  |  | payment |
 | `bill-sandbox` | Bill (Connect API Sandbox) | BILL | [docs](https://nango.dev/docs/integrations/all/bill-sandbox.md) | [connect](https://nango.dev/docs/integrations/all/bill-sandbox/connect.md) |  | payment |
 | `bing-webmasters` | Bing Webmasters | OAUTH2 | [docs](https://nango.dev/docs/api-integrations/bing-webmasters.md) |  | [setup](https://nango.dev/docs/api-integrations/bing-webmasters/how-to-register-your-own-bing-webmasters-api-oauth-app.md) | dev-tools |

docs/integrations/all/bigcommerce.mdx

@@ -8,6 +8,7 @@
 | Auth parameters validation | ✅ |
 | Pre-built authorization UI | ✅ |
 | Custom authorization UI | ✅ |
+| End-user authorization guide | ✅ |
 | Expired credentials detection | ✅ |
 </Accordion>
 <Accordion title="✅ Read & write data">

docs/llms-full.txt

@@ -3273,19 +3273,23 @@ bigcommerce:
         grant_type: authorization_code
     proxy:
         base_url: https://api.bigcommerce.com/stores/${connectionConfig.storeHash}
-    docs: https://nango.dev/docs/integrations/all/bigcommerce
+        headers:
+            x-auth-token: ${accessToken}
+    docs: https://nango.dev/docs/api-integrations/bigcommerce
+    docs_connect: https://nango.dev/docs/api-integrations/bigcommerce/connect
+    setup_guide_url: https://nango.dev/docs/api-integrations/bigcommerce/how-to-register-your-own-bigcommerce-api-oauth-app
     connection_config:
         storeHash:
             type: string
             title: Store Hash
-            description: The store hash of your BigCommerce account
+            example: hpj4hvw2bb
+            description: The store hash of your BigCommerce account.
             pattern: '^[a-zA-Z0-9]+$'
         accountUuid:
             type: string
-            title: Account UUID
-            description: The account UUID of your BigCommerce account
-            format: uuid
-            example: 123e4567-e89b-12d3-a456-426614174000
+            title: ''
+            description: ''
+            automated: true
 
 bill-sandbox:
     display_name: Bill (Connect API Sandbox)