API ReferenceConnected Accounts

Complete a deferred OAuth connection after identity verificationv3.1

POST
/api/v3.1/connected_accounts/complete_auth

Redeems a single-use session_uri handed to a project's OAuth callback verifier. Composio validates that the caller's project owns the pending connection and that user_id matches the connection owner, then completes the token exchange and returns the now-ACTIVE connected account. The session is single-use.

Authorization

ApiKeyAuth
x-api-key<token>

Project API key authentication

In: header

Request Body

application/json

session_uristringRequired

The opaque session URI received on the verifier redirect.

user_idstringRequired

The user this connection was initiated for.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://backend.composio.dev/api/v3.1/connected_accounts/complete_auth" \  -H "Content-Type: application/json" \  -d '{    "session_uri": "string",    "user_id": "string"  }'
{
  "connected_account_id": "string",
  "toolkit_slug": "string"
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
Edit this page on GitHub