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
-
101
## Rate limiting
102
103
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.