Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
docs: add callback URL FAQ, rename sections for clarity
Sushmithamallesheffcbf163b9a
diff --git a/docs/content/docs/authenticating-users/manually-authenticating.mdx b/docs/content/docs/authenticating-users/manually-authenticating.mdxindex 2742eda80..384951b16 100644--- a/docs/content/docs/authenticating-users/manually-authenticating.mdx+++ b/docs/content/docs/authenticating-users/manually-authenticating.mdx@@ -50,7 +50,7 @@ Redirect the user to the redirect URL. After they authenticate, they'll return tIf the user closes the Connect Link without completing auth, the connection remains in `INITIATED` status until it expires.</Callout>-## Callback URL+## Redirecting users after authenticationPass a `callbackUrl` to control where users land after authenticating. You can include query parameters to carry context through the flow, for example to identify which user or session triggered the connection.diff --git a/docs/content/docs/common-faq.mdx b/docs/content/docs/common-faq.mdxindex 5f21edf92..90b4ae635 100644--- a/docs/content/docs/common-faq.mdx+++ b/docs/content/docs/common-faq.mdx@@ -90,6 +90,12 @@ Every tool execution is logged in the [Composio dashboard](https://platform.compSee [Troubleshooting tools](/docs/troubleshooting/tools) for how to use logs to debug failed executions.</Accordion>+<Accordion title="How do I redirect users back to my app after they connect?">+Pass a `callbackUrl` when calling `link()`, `initiate()`, or `session.authorize()`. After authentication, Composio redirects the user to that URL with `status=success` or `status=failed` and the `connected_account_id` appended as query parameters.++You can include your own query parameters in the callback URL (e.g., `?user_id=user_123&source=onboarding`) to carry context through the flow. Composio preserves them. See [sessions](/docs/authenticating-users/manually-authenticating#redirecting-users-after-authentication) or [direct tool setup](/docs/tools-direct/authenticating-tools#redirecting-users-after-authentication).+</Accordion>+<Accordion title="Can Composio be self-hosted?">Yes, Composio supports self-hosting on the Enterprise plan. See [pricing](https://composio.dev/pricing) for details or [talk to us](https://calendly.com/composiohq/enterprise).</Accordion>diff --git a/docs/content/docs/tools-direct/authenticating-tools.mdx b/docs/content/docs/tools-direct/authenticating-tools.mdxindex 44adb5a37..5f6b62254 100644--- a/docs/content/docs/tools-direct/authenticating-tools.mdx+++ b/docs/content/docs/tools-direct/authenticating-tools.mdx@@ -162,7 +162,7 @@ These settings will apply to all authentication flows using Connect Link, providFor complete white-labeling including OAuth consent screens (removing Composio's domain), see [Custom Auth Configs - White-labeling](/docs/auth-configuration/custom-auth-configs#white-labeling-the-oauth-consent-screen).</Callout>-#### Passing query parameters in the callback URL+#### Redirecting users after authenticationYou can include custom query parameters in your callback URL to carry context through the auth flow, such as identifying which user or session triggered the connection. Composio preserves your parameters and appends its own after authentication completes:@@ -249,7 +249,7 @@ console.log(`Connection established: ${connectedAccount.id}`);</Tabs><Callout type="info">-Your callback URL can include query parameters to carry context through the auth flow. Note that `initiate()` uses camelCase parameters (`connectedAccountId`, `appName`) in the redirect, unlike `link()` which uses snake_case (`connected_account_id`). See [Passing query parameters in the callback URL](#passing-query-parameters-in-the-callback-url) for details.+Your callback URL can include query parameters to carry context through the auth flow. Note that `initiate()` uses camelCase parameters (`connectedAccountId`, `appName`) in the redirect, unlike `link()` which uses snake_case (`connected_account_id`). See [Redirecting users after authentication](#redirecting-users-after-authentication) for details.</Callout>#### Services with Additional Parameters