---
title: "Get connector connection status"
method: GET
path: "/api/apps/{app_id}/external-auth/status"
---

# Get connector connection status

`GET /api/apps/{app_id}/external-auth/status`

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

Returns where a connector authorization you started with [Start connector connection](/api-reference/start-connector-connection) stands. Poll it every few seconds after opening the link, until `status` is `ACTIVE` or `FAILED`.

An authorization nobody completes stays `PENDING`, so stop polling a few minutes after the link expires. A connection another collaborator started always reads as `PENDING` to you.

This is limited to 70 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>

## Path parameters

- `app_id` string, required — ID of the app.

## Query parameters

- `integration_type` union, required — Connector the authorization is for.
  - 'googlecalendar' | 'google_classroom' | 'googledrive' | 'gmail' | 'googlesheets' | 'googledocs' | 'googleslides' | 'googlebigquery' | 'googlemeet' | 'googletasks' | 'googleads' | 'google_analytics' | 'google_search_console' | 'slack' | 'notion' | 'salesforce' | 'hubspot' | 'linkedin' | 'tiktok' | 'instagram' | 'discord' | 'slackbot' | 'wix' | 'github' | 'gitlab' | 'bamboohr' | 'dropbox' | 'clickup' | 'wrike' | 'box' | 'outlook' | 'linear' | 'airtable' | 'microsoft_teams' | 'share_point' | 'one_drive' | 'typeform' | 'splitwise' | 'hugging_face' | 'calendly' | 'contentful' | 'supabase' | 'snowflake' | 'databricks' | 'quickbooks' | 'square'
  - string
- `connection_id` string, required — `connection_id` returned by [Start connector connection](/api-reference/start-connector-connection).

## Response `200`

Where the authorization stands.

- IntegrationPollingStatusResult — Where a connector authorization stands.
  - `status` 'ACTIVE' | 'FAILED' | 'PENDING', required — Enum for integration polling statuses.
  - `status_reason` string, nullable — Why the authorization failed, when `status` is `FAILED` and you started it. The value is `null` otherwise.

## Other responses

- `401` — Missing or invalid credentials.
- `403` — You don't have editor access to this app, or you used a workspace API key.
- `404` — App not found, or the connector isn't available to you and the app has no connection for it.
- `409` — The app's workspace requires an unlocked SSO session.
- `422` — `integration_type` or `connection_id` is missing, or `integration_type` isn't a valid connector ID.
- `429` — Rate limit reached. Retry later.

## Changes

> 22 revisions in range; 1 not diffed.

- **2026-09-29** `d2b7ac8beb0c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/adexad/apis/base44-app-management-api/changes/api/apps/:app_id/external-auth/status/get.md)

---

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