Skip to main content

Get list of Actor OAuth connections

GET 
/v2/actors/:actorId/oauth-connections

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.

Request

Path Parameters

    actorId string required

    Actor ID or the username of the Actor owner and the Actor name, separated by a tilde (~).


    Example: compass~google-maps-extractor

Status 200

Response Headers
    {
      "data": {
        "total": 1,
        "items": [
          {
            "_id": "kD9fm2Xp4cJq7Lw8N",
            "actorId": "zdc3Pyhyz3m8vjDeM",
            "oAuthProviderType": "GOOGLE",
            "createdAt": "2026-01-28T10:00:00.000Z",
            "modifiedAt": "2026-01-28T10:00:00.000Z",
            "credentials": {
              "clientId": "1234567890-abc.apps.googleusercontent.com",
              "scope": "https://www.googleapis.com/auth/drive.file",
              "label": "My OAuth app",
              "imageUrl": "https://example.com/logo.png"
            }
          }
        ]
      }
    }