---
title: "List connectors"
method: GET
path: "/api/external-auth/available-integrations"
---

# List connectors

`GET /api/external-auth/available-integrations`

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns every connector you can connect to an app, with what each one needs before authorization. Use `integration_type` from here on the app connector endpoints.

The list can differ between callers, because some connectors reach only some accounts while they roll out. It isn't paginated.

This is limited to 60 requests a minute per caller. Some workspaces have a different limit.

<Note>This endpoint accepts a personal API key, including a read-only key. Workspace API keys are not accepted.</Note>

## Response `200`

The connectors available to you.

- ListIntegrationTypesResponse — The connectors available to you.
  - `integrations` IntegrationTypeInfo[], required — Every connector available to you. Sort by `catalog_order` to list them the way Base44 does.
    - `integration_type` string, required — ID of the connector. Use it as `integration_type` on the app connector endpoints.
    - `display_name` string, required — Name of the connector.
    - `description` string, required — What the connector gives an app access to.
    - `auth_method` 'oauth' | 'platform_credentials' — How the connector authenticates. Either `oauth`, where someone signs in to the provider, or `platform_credentials`, where it runs on Base44's own credentials and has no authorization to start.
    - `connection_config_fields` ConnectionConfigField[], required — Values to collect before authorization, sent as `connection_config`. Empty for most connectors.
      - `name` string, required — Key to send the value under in `connection_config`.
      - `display_name` string — Label for the value.
      - `description` string — Help text that explains where to find the value.
      - `placeholder` string — Sample value to show in an empty input.
      - `required` boolean — Whether the value has to be sent (`true`) or can be left out (`false`).
      - `default_value` string, nullable — Value used when the field is left out, or `null` if there is none.
      - `validation_pattern` string, nullable — Regular expression the whole value has to match, or `null` if any value is accepted.
      - `validation_error` string, nullable — Message returned when the value doesn't match `validation_pattern`, or `null` for the default message.
    - `connector_mode` 'all' | 'shared_only' | 'app_user_only' | 'byo_shared_only' | 'byo_shared_and_app_user' — Which ways a connector can be connected.
    - `subtitle` string, nullable — Short tagline, or `null` if the connector has none.
    - `category` string — Group the connector is listed under.
    - `display_status` string — Release stage of the connector. One of `active`, `beta`, or `coming_soon`.
    - `icon_svg` string, nullable — The connector's logo as inline SVG markup, or `null` if it has none.
    - `release_date` string, nullable — When the connector was released, in `YYYY-MM-DD` format, or `null` if unknown.
    - `popularity` integer — Ranking hint where a lower number is more prominent, starting at 1. `0` means the connector has no rank.
    - `catalog_order` integer, nullable — Position in the catalog, or `null` for connectors listed after the ordered ones.
    - `example_scopes` string[] — Scopes an app typically asks for.
    - `access_modes` AccessModesView — Read-only / full-access scope groupings exposed via the catalog API.
      - `read_only` string[], required — Scopes to ask for when the app only needs to read.
      - `full_access` string[], required — Scopes to ask for when the app also needs to make changes.
    - `example_prompts` string[] — Sample requests to the app's AI chat that use the connector.
    - `is_public_client` boolean — Whether the provider's OAuth app authenticates with a client ID alone (`true`), so a workspace connector needs no client secret, or also needs a secret (`false`).
    - `supports_base44_app_user` boolean — Whether the app's users can connect their own accounts through Base44's OAuth app (`true`) or only through the workspace's own (`false`).
    - `base44_app_user_allowed_scopes` string[], nullable — Scopes Base44's OAuth app can grant the app's users, or `null` when it sets no limit.

## Other responses

- `401` — Missing or invalid credentials.
- `409` — Your active workspace requires an unlocked SSO session.
- `429` — Rate limit reached. Retry later.

## Changes

- **2026-09-30** `63675fa5257c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/idealspot/apis/base44-app-management-api/changes/api/external-auth/available-integrations/get.md)

---

[API](https://skmtc.dev/idealspot/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/idealspot/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/idealspot/apis/base44-app-management-api/revisions/e58d4ff7b1f8?raw)