---
title: "Get list of Actor OAuth connections"
method: GET
path: "/v2/actors/{actorId}/oauth-connections"
tags: ["Actors"]
---

# Get list of Actor OAuth connections

`GET /v2/actors/{actorId}/oauth-connections`

## Request

- Base URL: `https://api.apify.com`
- URL: `https://api.apify.com/v2/actors/{actorId}/oauth-connections`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `token`

Gets the OAuth connections configured on the Actor. Each connection defines an OAuth provider that users of the
Actor can connect their accounts through. Only public credential fields are returned, never the client secret.

An Actor has at most 5 connections, so the list is not paginated.

You need read access to the Actor.

## Path parameters

- `actorId` string, required

## Response `200`

- ListOfActorOAuthConnectionsResponse
  - `data` ListOfActorOAuthConnections, required
    - `total` integer, required
    - `items` ActorOAuthConnection[], required
      - `_id` string, required
      - `actorId` string, required
      - `oAuthProviderType` 'CUSTOM' | 'GOOGLE', required
      - `createdAt` string, date-time, required
      - `modifiedAt` string, date-time, required
      - `credentials` object: The public part of the connection's OAuth client configuration.
        - `clientId` string
        - `scope` string
        - `label` string: Display name of a `CUSTOM` provider.
        - `imageUrl` string: Logo URL of a `CUSTOM` provider.

## Other responses

- `400`: Bad request - invalid input parameters or request body.
- `401`: Unauthorized - authentication required or invalid token.
- `403`: Forbidden - insufficient permissions to perform this action.
- `404`: Not found - the requested resource does not exist.
- `405`: Method not allowed.
- `429`: Too many requests - rate limit exceeded.

## Changes

> 25 revisions in range; 1 not diffed.

- **2026-10-27** `ec76185eb934`: 6 info
  - added the optional property `error/data` to the response with the `400` status
  - added the optional property `error/data` to the response with the `401` status
  - added the optional property `error/data` to the response with the `403` status
  - added the optional property `error/data` to the response with the `404` status
  - …2 more
- **2026-10-27** `e52dd2239cee`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/apify/apis/apify-api/changes/v2/actors/:actorId/oauth-connections/get.md)

---

[API](https://skmtc.dev/apify/apis/apify-api.md) - [All operations](https://skmtc.dev/apify/apis/apify-api/llms.txt) - [OpenAPI document](https://skmtc.dev/apify/apis/apify-api/revisions/68d2d102e6a2?raw)