Connected Accounts
Get connected account auth credentials
Retrieves complete authentication details for a connected account including OAuth tokens, refresh tokens, scopes, and API configuration. Query by account ID or by combination of organization/user, connector, and identifier. Returns sensitive credential information - use appropriate access controls.
get/api/v1/connected_accounts/auth
Query parameters
organization_idstring
Organization ID for the connector
user_idstring
User ID for the connector
connectorstring
Connector identifier (e.g., 'notion', 'slack', 'google'). Alphanumeric characters, spaces, hyphens, underscores, and colons are allowed.
identifierstring
The unique identifier for the connected account within the third-party service (e.g., email address, user ID, workspace identifier).
idstring
Unique identifier for the connected account
Response
Successfully retrieved connected account with full authentication details
Example response
{
"connected_account": {
"api_config": {
"base_url": "https://api.custom-domain.com",
"rate_limit": 1000,
"timeout": 30
},
"authorization_details": {
"google_dwd": {
"access_token": "ya29.a0AfH6SMBx...",
"scopes": [
"openid",
"https://www.googleapis.com/auth/userinfo.email"
],
"subject": "user@example.com"
},
"oauth_token": {
"access_token": "ya29.a0AfH6SMBx...",
"domain": "example.com",
"refresh_token": "1//0gHJxZ-Lb2...",
"scopes": [
"https://www.googleapis.com/auth/drive.readonly",
"https://www.googleapis.com/auth/userinfo.email"
]
},
"static_auth": {
"details": {
"api_key": "sk_live_...",
"api_secret": "..."
}
},
"trusted_idp": {
"access_key_id": "ASIA...",
"db_user": "analytics_reader"
}
},
"connection_id": "conn_24834495392086178",
"connector": "notion",
"id": "ca_24834495392086178",
"identifier": "user@example.com",
"last_used_at": "2024-03-20T14:30:00Z",
"provider": "google",
"token_expires_at": "2024-12-31T23:59:59Z",
"updated_at": "2024-03-20T15:04:05Z"
}
}