Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

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.mdx
index 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 t
If the user closes the Connect Link without completing auth, the connection remains in `INITIATED` status until it expires.
</Callout>
-## Callback URL
+## Redirecting users after authentication
Pass 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.mdx
index 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.comp
See [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.mdx
index 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, provid
For 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 authentication
You 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