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>

get/api/apps/{app_id}/external-auth/list

Request

  • Base URL: https://app.base44.com
  • URL: https://app.base44.com/api/apps/{app_id}/external-auth/list
  • Auth: HTTP bearer

Path parameters

app_idstring required

ID of the app.

Response

The app's connector connections.

school_blocked_connector_typesstring[]

Connectors requiring school approval before shared accounts can connect.

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