auth0 · pmalouin · Nov 19, 2025 · Oct 17, 2025 · Oct 17, 2025 · Oct 17, 2025
diff --git a/auth4genai/docs.json b/auth4genai/docs.json
@@ -56,7 +56,6 @@
                 "pages": [
                   "intro/token-vault",
                   "intro/integrations",
-                  "intro/account-linking",
                   "intro/call-others-apis-on-users-behalf"
                 ]
               },
@@ -88,13 +87,6 @@
             "icon": "robot",
             "pages": ["sample-apps"]
           },
-          {
-            "group": "Guides",
-            "icon": "graduation-cap",
-            "pages": [
-              "guides/client-initiated-account-linking"
-            ]
-          },
           {
             "group": "Glossary",
             "icon": "compass",

diff --git a/auth4genai/get-started/call-others-apis-on-users-behalf.mdx b/auth4genai/get-started/call-others-apis-on-users-behalf.mdx
@@ -13,8 +13,9 @@ Use Auth0 SDKs to fetch access tokens for social and enterprise identity provide
 
 By the end of this quickstart, you should have an AI application integrated with Auth0 that can:
 
-1. Retrieve access tokens for a Google social connection.
-2. Integrate with an AI agent to call Google APIs.
+1. Initiate a Connected Accounts flow that will allow the user to connect their Google account and grant access to the AI agent.
+2. Retrieve access tokens for a Google social connection.
+3. Integrate with an AI agent to call Google APIs.
 
 ## Pick your tech stack
 
@@ -50,5 +51,4 @@ By the end of this quickstart, you should have an AI application integrated with
 You have successfully added the ability to get access tokens for tool calling to your application. For next steps:
 
 - [Call your APIs on user's behalf docs](/intro/call-your-apis-on-users-behalf).
-- Learn more about [Client-initiated account linking](/guides/client-initiated-account-linking).
 - Learn more about how Auth0's [Token Vault](https://auth0.com/docs/secure/tokens/token-vault) manages the tokens of supported identity providers.
diff --git a/auth4genai/guides/client-initiated-account-linking.mdx b/auth4genai/guides/client-initiated-account-linking.mdx
diff --git a/auth4genai/integrations/basecamp.mdx b/auth4genai/integrations/basecamp.mdx
@@ -37,10 +37,10 @@ Connect your AI agent to a user's Basecamp account to create new projects, add t
 
 To configure the Token Vault for your Basecamp connection, you can use the following code snippet in your application:
 
-<TokenVaultConfigBlock 
+<TokenVaultConfigBlock
   providerName="Basecamp"
   connectionName="basecamp"
-  scopes={["profile"]}
+  scopes={[]}
 />
 
-<NextStepsBlock />
+<NextStepsBlock />
diff --git a/auth4genai/integrations/bitbucket.mdx b/auth4genai/integrations/bitbucket.mdx
@@ -40,10 +40,10 @@ Connect your AI agent to Bitbucket to manage repositories, automate pull request
 
 To configure the Token Vault for your Bitbucket connection, you can use the following code snippet in your application:
 
-<TokenVaultConfigBlock 
+<TokenVaultConfigBlock
   providerName="Bitbucket"
   connectionName="bitbucket"
-  scopes={["profile"]}
+  scopes={[]}
 />
 
-<NextStepsBlock />
+<NextStepsBlock />
diff --git a/auth4genai/integrations/box.mdx b/auth4genai/integrations/box.mdx
@@ -1,38 +1,40 @@
 ---
 title: Box
-description: "Connect your AI Agents to Box for file management and collaboration."
 ---
 
 import FindDomainInfoBlock from "/snippets/common/find-domain-info-block.mdx";
-import AddConnectionInAuth0 from "/snippets/integrations/add-connection-auth0.mdx";
-import LearnMore from "/snippets/integrations/learn-more.mdx";
+import { IntegrationInfoBlock } from "/snippets/integrations/IntegrationInfoBlock.jsx";
+import { Auth0SetupBlock } from "/snippets/integrations/Auth0SetupBlock.jsx";
+import { TokenVaultConfigBlock } from "/snippets/integrations/TokenVaultConfigBlock.jsx";
+import  NextStepsBlock  from "/snippets/integrations/next-step.mdx";
 
-The Box integration enables your AI Agents to authenticate users with their Box accounts and access their file storage.
+Connect your AI Agents to Box for file management and collaboration.
 
-## Overview
-
-Box is an enterprise-focused cloud storage and collaboration platform. This integration allows AI agents to securely access, manage, and collaborate on files stored in Box, making it ideal for business applications that need document management capabilities.
-
-## Configuration
+## Connect Box to Auth0
 
 <Steps>
-  <Step title="Set up app in Box">
+  <Step title="Box Setup">
 
     1. Sign up for a [Box Developer account](https://developers.box.com/)
     2. Set up an app using Box's [Custom Apps: Setup with OAuth 2.0](https://developer.box.com/guides/applications/custom-apps/oauth2-setup/) documentation
     3. Note your **Client ID** and **Client Secret**
 
   </Step>
-  <Step title="Configure for Auth0">
-
-    1. Use the following settings when configuring your app:
-      - Redirect URI: `https://YOUR_AUTH0_DOMAIN/login/callback`
-      - Application Scopes: Select the permissions you want to enable for this connection.
-    <FindDomainInfoBlock />
-
+  <Step title="Auth0 setup">
+    <Auth0SetupBlock providerName="Box" scopesName="Attributes" allowFreeFormScopes={true} />
   </Step>
 </Steps>
 
-<AddConnectionInAuth0 />
+<IntegrationInfoBlock providerName="Box" />
+
+## Token Vault configuration example
+
+To configure the Token Vault for your Box connection, you can use the following code snippet in your application:
+
+<TokenVaultConfigBlock
+  providerName="Box"
+  connectionName="box"
+  scopes={[]}
+/>
 
-<LearnMore />
+<NextStepsBlock />
diff --git a/auth4genai/integrations/digitalocean.mdx b/auth4genai/integrations/digitalocean.mdx
@@ -26,6 +26,7 @@ Connect your AI agent to a user's DigitalOcean account to automate the creation
     5. Click **Register OAuth Application** and note your **Client ID** and **Client Secret**.
 
     To learn more about DigitalOcean OAuth setup, read the [DigitalOcean OAuth API documentation](https://docs.digitalocean.com/reference/api/oauth/).
+
   </Step>
   <Step title="Auth0 setup">
     <Auth0SetupBlock providerName="DigitalOcean" scopesName="Scopes" allowFreeFormScopes={true} />
@@ -38,10 +39,11 @@ Connect your AI agent to a user's DigitalOcean account to automate the creation
 
 To configure the Token Vault for your DigitalOcean connection, you can use the following code snippet in your application:
 
-<TokenVaultConfigBlock 
+<TokenVaultConfigBlock
   providerName="DigitalOcean"
   connectionName="digitalocean"
-  scopes={["account:read", "droplet:create", "kubernetes:read"]}
+  scopes={["account:read"]}
+  optionalScopes={["droplet:create", "kubernetes:read"]}
 />
 
-<NextStepsBlock />
+<NextStepsBlock />
diff --git a/auth4genai/integrations/discord.mdx b/auth4genai/integrations/discord.mdx
@@ -23,7 +23,7 @@ Connect your AI agent to a Discord server to welcome new members, play music, ma
     5. Set permissions/scopes you need:
        - For basic login, the **identify** scope is generally required to get basic user information
     6. Save changes
-    
+
     To learn more about setting up Discord, read the [Login with Discord documentation](https://discord.com/developers/docs/topics/oauth2).
   </Step>
   <Step title="Auth0 setup">
@@ -37,10 +37,10 @@ Connect your AI agent to a Discord server to welcome new members, play music, ma
 
 To configure the Token Vault for your Discord connection, you can use the following code snippet in your application:
 
-<TokenVaultConfigBlock 
+<TokenVaultConfigBlock
   providerName="Discord"
   connectionName="discord"
-  scopes={["identify"]}
+  scopes={["email","identify"]}
 />
 
-<NextStepsBlock />
+<NextStepsBlock />
diff --git a/auth4genai/integrations/dropbox.mdx b/auth4genai/integrations/dropbox.mdx
@@ -32,7 +32,7 @@ Connect your AI agent to a user's Dropbox account to automatically organize file
     To learn more about setting up Dropbox, read the [Developer guide for Dropbox documentation](https://www.dropbox.com/developers/documentation/http/documentation).
   </Step>
   <Step title="Auth0 setup">
-    <Auth0SetupBlock providerName="Dropbox" scopesName="Attributes" />
+    <Auth0SetupBlock providerName="Dropbox" scopesName="Attributes" allowOfflineAccess={true} />
   </Step>
 </Steps>
 
@@ -42,10 +42,10 @@ Connect your AI agent to a user's Dropbox account to automatically organize file
 
 To configure the Token Vault for your Dropbox connection, you can use the following code snippet in your application:
 
-<TokenVaultConfigBlock 
+<TokenVaultConfigBlock
   providerName="Dropbox"
   connectionName="dropbox"
-  scopes={["profile","offline"]}
+  scopes={["account_info.read"]}
 />
 
-<NextStepsBlock />
+<NextStepsBlock />
diff --git a/auth4genai/integrations/figma.mdx b/auth4genai/integrations/figma.mdx
@@ -37,10 +37,11 @@ Connect your AI agent to a user's Figma account to export assets, apply changes
 
 To configure the Token Vault for your Figma connection, you can use the following code snippet in your application:
 
-<TokenVaultConfigBlock 
+<TokenVaultConfigBlock
   providerName="Figma"
   connectionName="figma"
-  scopes={["current_user:read", "file_content:read", "file_comments:write"]}
+  scopes={["current_user:read"]}
+  optionalScopes={["file_content:read", "file_comments:write"]}
 />
 
 <NextStepsBlock />
diff --git a/auth4genai/integrations/fitbit.mdx b/auth4genai/integrations/fitbit.mdx
@@ -39,10 +39,11 @@ Connect your AI agent to a user's Fitbit account to track fitness data, log acti
 
 To configure the Token Vault for your Fitbit connection, you can use the following code snippet in your application:
 
-<TokenVaultConfigBlock 
+<TokenVaultConfigBlock
   providerName="Fitbit"
   connectionName="fitbit"
-  scopes={["profile","activity"]}
+  scopes={["profile"]}
+  optionalScopes={["activity"]}
 />
 
-<NextStepsBlock />
+<NextStepsBlock />
diff --git a/auth4genai/integrations/freshbooks.mdx b/auth4genai/integrations/freshbooks.mdx
@@ -40,10 +40,47 @@ Connect your AI agent to a user's FreshBooks account to create and send invoices
 
 To configure the Token Vault for your FreshBooks connection, you can use the following code snippet in your application:
 
-<TokenVaultConfigBlock 
-  providerName="Freshbooks"
-  connectionName="freshbooks"
-  scopes={["user:profile:read", "user:clients:read", "user:invoices:read"]}
-/>
+<Tabs>
+  <Tab title="JavaScript" icon="js">
+    ```tsx wrap lines
+    const auth0AI = new Auth0AI();
+
+    export const withFreshbooksConnection = auth0AI.withTokenVault({
+      connection: "freshbooks",
+      scopes: [
+          // required scopes for Token Vault
+          "user:profile:read",
+          // optional scopes specific to your app
+          ...
+      ],
+      refreshToken: getAuth0RefreshToken(),
+      authorizationParams: {
+        prompt: "login",
+      },
+    });
+    ```
+
+  </Tab>
+  <Tab title="Python" icon="python">
+    ```python wrap lines
+    auth0_ai = Auth0AI()
+
+    with_freshbooks_connection = auth0_ai.with_token_vault(
+        connection="freshbooks",
+        scopes=[
+            # required scopes for Token Vault
+            "user:profile:read",
+            # optional scopes specific to your app
+            ...
+        ],
+        refresh_token=get_auth0_refresh_token,
+        authorization_params={
+            "prompt": "login",
+        },
+    )
+    ```
+
+  </Tab>
+</Tabs>
 
 <NextStepsBlock />