---
title: "List connections made through the organization's OAuth client"
method: GET
path: "/v1/integrations/oauth-clients/{provider}/connections"
tags: ["integrations"]
---

# List connections made through the organization's OAuth client

`GET /v1/integrations/oauth-clients/{provider}/connections`

List who has connected through the organization's own OAuth client for a connector.

Empty when no client is registered for the connector. Connections made through the Mixedbread
client are not included.

## Path parameters

- `provider` 'google_drive' | 'gmail' | 'slack', required — The connector to inspect

## Response `200`

Connections authorized through the customer-owned client, newest first

- OAuthClientConnectionListResponse — The connections authorized through the organization's own Google OAuth client for a connector.
  - `data` OAuthClientConnection[], required — Connections authorized through the customer-owned client, newest first
    - `installation_id` string, required — Installation ID
    - `provider` 'google_drive' | 'gmail' | 'slack', required — The connector the account is connected to
    - `status` string, required — Installation status
    - `account` ConnectorAccount, required — The third-party account an installation is authorized as.
      - `id` string, required — Provider-side account identifier (email, user ID, or team ID)
      - `name` string, nullable — Human-readable account name
      - `email` string, nullable — Account email, when the provider exposes one
      - `workspace` string, nullable — Workspace or organization the account belongs to, for providers that have one
    - `store_id` string, nullable — Store the installation ingests into
    - `store_name` string, nullable — Name of that store
    - `sync` ConnectorInstallationSync — Account-level sync facts: how many resources are in error, and the last failure of an account-wide job.
      - `failed_resource_count` integer — Resources whose last sync job failed
      - `last_error` string, nullable — Last failure of a job covering the whole account, such as a changes sync
      - `last_error_operation` string, nullable — Which account-wide job failed
      - `last_error_at` string, date-time, nullable — When it failed
    - `installed_by_user_id` string, nullable — The dashboard user who authorized the connection, or null when an API key did
    - `connected_at` string, nullable — When the connection was authorized
    - `updated_at` string, nullable — When the connection last changed

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-07** `1a6549d3e64d` — 1 info
  - added the optional property `data/items/sync` to the response with the `200` status
- **2026-09-05** `ea8d85b8caca` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mixedbread/apis/mxbai-omni/changes/v1/integrations/oauth-clients/:provider/connections/get.md)

---

[API](https://skmtc.dev/mixedbread/apis/mxbai-omni.md) · [All operations](https://skmtc.dev/mixedbread/apis/mxbai-omni/llms.txt) · [OpenAPI document](https://skmtc.dev/mixedbread/apis/mxbai-omni/revisions/427a5c58f68a?raw)
