Connected Accounts

Complete a deferred OAuth connection after identity verification

Changed on

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.

post/api/v3.1/connected_accounts/complete_auth

Request

  • Base URL
    https://backend.composio.dev
  • URL
    https://backend.composio.dev/api/v3.1/connected_accounts/complete_auth
  • Auth
    API key in header x-api-key

Request body

session_uristring required

The opaque session URI received on the verifier redirect.

user_idstring required

The user this connection was initiated for.

Response

The connection was completed and is now ACTIVE.

connected_account_idstring required

The connection that was completed.

toolkit_slugstring required

The toolkit the connection belongs to.

Changes