Skip to main content

Get Actor OAuth account

GET 
/v2/actor-oauth-accounts/:accountId

Gets an account connected through an Actor OAuth connection, including its OAuth tokens.

This endpoint only accepts the API token of an Actor run (the APIFY_TOKEN environment variable of the run). The run must belong to the Actor that the account's OAuth connection is configured on, and the account must belong to the user the run's token acts for. Any other token gets a 403 error.

Request

Path Parameters

    accountId string required

    Actor OAuth account ID.


    Example: Rk3mP8xQ2vN5tY7wZ

Status 200

Response Headers
    {
      "data": {
        "_id": "Rk3mP8xQ2vN5tY7wZ",
        "userId": "wRsJZtadYvn4mBZmm",
        "connectionId": "kD9fm2Xp4cJq7Lw8N",
        "createdAt": "2026-01-28T10:00:00.000Z",
        "modifiedAt": "2026-01-28T10:05:00.000Z",
        "authorizedAt": "2026-01-28T10:05:00.000Z",
        "description": "jane.doe@example.com",
        "data": {}
      }
    }