List connector connections
Changed on<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>
Returns the app's connector connections, whether active, expired, or disconnected, with who made each one and the scopes it was granted. Read status to tell whether a connection still works. Connections made with a workspace connector's own OAuth app aren't included.
Each active connection is checked as you list it, so status can read expired before the app next uses the connector. The list isn't paginated, since an app has at most one connection for each connector.
This is limited to 60 requests a minute per caller. Some workspaces have a different limit.
<Note>This endpoint accepts a personal API key belonging to a user with editor access to the app, including a read-only key. Workspace API keys are not accepted.</Note>
Request
- Base URL: https://app.base44.com
- URL: https://app.base44.com/api/apps/{app_id}/external-auth/list
- Auth: HTTP bearer
Path parameters
ID of the app.
Response
The app's connector connections.
Example response
{
"integrations": [
{
"auth_method": "oauth",
"connected_by_me": true,
"connection_id": "base44_6820f3a4e7b91d003c45a1f7",
"connection_ownership": "app",
"created_at": "2026-01-15T09:23:41Z",
"integration_account_identifier": "jane@acme.com",
"integration_type": "googlecalendar",
"requires_connection_config": false,
"scopes": [
"https://www.googleapis.com/auth/calendar.readonly"
],
"status": "active",
"user_email": "jane@acme.com"
}
],
"school_blocked_connector_types": [
"gmail"
]
}Changes
- info
added the optional property
to the response with the status
- info
- info
the endpoint scheme security
PersonalAccessTokenAuthwas added to the API
- info