COcomposiohq
Connected Accounts

Get connected account details by ID

Changed on

Retrieves comprehensive details of a connected account, including authentication configuration, connection status, and all parameters needed for API requests.

get/api/v3.1/connected_accounts/{nanoid}

Request

Path parameters

nanoidstring connectedAccountId required

The unique identifier (nanoid) of the connected account

Response

Successfully retrieved connected account details with all authentication parameters and connection status

idstring connectedAccountId required

The id of the connection

authScheme'OAUTH2' | 'OAUTH1' | 'API_KEY' | 'BASIC' | 'BILLCOM_AUTH' | 'BEARER_TOKEN' | 'GOOGLE_SERVICE_ACCOUNT' | 'NO_AUTH' | 'BASIC_WITH_JWT' | 'CALCOM_AUTH' | 'SERVICE_ACCOUNT' | 'SAML' | 'DCR_OAUTH' | 'CIMD_OAUTH' | 'S2S_OAUTH2'

Duplicates state.authScheme. Kept for backward compatibility with existing readers; use state.authScheme instead.

word_idstring nullable required

A short, token-friendly identifier for multi-account disambiguation, typically toolkit-prefixed with 1-2 words (e.g., "gmail_red-castle")

aliasstring nullable required

A user-defined alias for the connected account

user_idstring required

This is deprecated, we will not be providing userId from this api anymore, you will only be able to read via userId not get it back

status'INITIALIZING' | 'INITIATED' | 'ACTIVE' | 'FAILED' | 'EXPIRED' | 'INACTIVE' | 'REVOKED' required

The status of the connection

created_atstring required

The created at of the connection

updated_atstring required

The updated at of the connection

dataobject required

This is deprecated, use state instead

status_reasonstring nullable required

The reason the connection status changed.

is_disabledboolean required

Whether the connection is disabled

test_request_endpointstring

The endpoint to make test request for verification

paramsobject required

The initialization data of the connection, including configuration parameters

requested_scopesstring[]

OAuth scopes requested when this connection was most recently initiated (create or refresh). Absent for connections created before scope snapshots were captured and for non-OAuth auth schemes.

requested_user_scopesstring[]

OAuth user-token scopes requested at the most recent initiation. Only meaningful for Slackbot auth configs (user-token scopes); absent otherwise.

Changes

  • 98956f31abf3Revision changes
    • breaking

      the response's property type changed from no type to object for status

    • warning

      added the new CIMD_OAUTH enum value to the / response property for the response status

    • info

      api operation id getV3_1ConnectedAccountsByNanoid removed and replaced with getConnectedAccountsByNanoid

    • info

      api tag Account Management removed

    • info

      added the optional property to the response with the status

    • info

      removed subschema #1 subschema #2 subschema #3 subschema #4 subschema #5 subschema #6 subschema #7 subschema #8 subschema #9 subschema #10 subschema #11 subschema #12 subschema #13 subschema #14 from the response property oneOf list for the response status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

  • 1d3aac1128efRevision changes
    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property from the response with the status