Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Mirrored from https://github.com/Camo67/composio.git
Synced Nov 21, 22:15 UTC
docs(reference): add Error 600 section so suggested_fix URL resolves
Adds the canonical reference entry for ConnectedAccount_BadRequest (code 600), including the response shape, the SDK-level fix, and links to the migration guide and changelog. The suggested_fix URL emitted by the API points at #error-600 — without this section it 404s. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Composio committed
Apr 25, 2026 at 18:12 UTC
e6abaff68e461fc664b05e774ead9cf721aaa99e
1 file changed
+32
docs/content/reference/errors.mdx
+32
@@ -98,6 +98,38 @@ Errors related to trigger subscriptions.
98
See [Triggers Troubleshooting](/docs/troubleshooting/triggers) for more help.
99
</Callout>
100
101
+## Specific error codes
102
+
103
+When the API response includes a numeric `code` in the error object, you can look it up here for a focused explanation and the canonical fix. The `suggested_fix` field on each error response also points back to this section.
104
+
105
+### Error 600
106
+
107
+`ConnectedAccount_BadRequest`. Returned by `POST /api/v3/connected_accounts` (HTTP 400) when the request is for a **Composio-managed auth config on a redirectable OAuth scheme** (OAuth1, OAuth2, DCR_OAUTH). This combination is being retired on the legacy create endpoint — **2026-05-08** for new organizations and **2026-07-03** for all remaining organizations.
108
+
109
+**Example response:**
110
+
111
+```json
112
+{
113
+ "error": {
114
+ "message": "Creating connections on this endpoint for Composio-managed OAuth auth configs is no longer supported. Use POST /api/v3/connected_accounts/link instead.",
115
+ "code": 600,
116
+ "slug": "ConnectedAccount_BadRequest",
117
+ "status": 400,
118
+ "request_id": "...",
119
+ "suggested_fix": "Call POST /api/v3/connected_accounts/link with the same auth_config_id and user_id to get a redirect URL for the end user."
120
+ }
121
+}
122
+```
123
+
124
+**Fix.** Switch the call to `POST /api/v3/connected_accounts/link`, or use the SDK helper:
125
+
126
+- TypeScript: `composio.connectedAccounts.link(userId, authConfigId, options?)` (replaces `composio.connectedAccounts.initiate(...)`).
127
+- Python: `composio.connected_accounts.link(user_id, auth_config_id, **options)` (replaces `composio.connected_accounts.initiate(...)`).
128
+
129
+The return shape is the same — both methods give you a `redirect_url` (or `redirectUrl`) and a `wait_for_connection()` / `waitForConnection()` helper. See the [migration guide](/docs/auth-configuration/migrating-initiate-to-link) and the [changelog entry](/docs/changelog/2026/04/24).
130
+
131
+**Not affected by error 600:** custom auth configs (your own OAuth app) and non-OAuth schemes (API key, bearer token, basic auth) continue to work on `POST /api/v3/connected_accounts` indefinitely.
132
+
133
## Rate limiting
134
135
When you hit rate limits, you'll receive a `429` status code. See [Rate Limits](/reference/rate-limits) for details on limits by plan and best practices for handling rate limit errors.