v63

latestOpenAPI 3.0.0Proprietaryraw.githubusercontent.com2026-08-0110571.8 MB

Connected Accounts

Account Management

Get connected account details by ID

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}

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

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

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. Possible reasons: Connection initiation did not complete within 10 minutes, Permanent auth error during token refresh, Max auth failures reached, OAuth callback failed during token exchange, Connection status updated by user, Auth config is disabled, Revoked via user-initiated revoke endpoint, Revoked via admin tool, Revoked as part of connection delete

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.