Pending Connections

Get pending connection details

Retrieve details of a pending OAuth connection, including available pages/accounts that can be connected. This endpoint is used during the OAuth finalization flow for platforms like LinkedIn and Facebook that support multiple pages/profiles.

Authentication: Requires your API key, and the session token must belong to the same organization as that key. A session token from another organization is rejected as if it had expired. Because the API key is required, call this from your backend - not from the browser your user was redirected to.

Tokens are never returned. The response describes each page only well enough to render a picker (id, name, profilePictureUrl and similar). Provider access tokens stay server-side and are attached to the account when you finalize.

Flow:

  1. User completes OAuth authentication
  2. Callback redirects to your page with ?session=xxx
  3. Your backend calls this endpoint to get available pages. Strip the session parameter from the browser URL once you have read it - it lands in history, logs and Referer headers otherwise
  4. User selects which pages to connect
  5. Call POST /finalize to complete the connection
get/v1/social-accounts/pending/{sessionToken}

Request

  • Base URL: https://api.outstand.so
  • URL: https://api.outstand.so/v1/social-accounts/pending/{sessionToken}
  • Auth: none declared

Path parameters

sessionTokenstring required

Response

Pending connection retrieved successfully

successboolean required

Example response

{
  "success": true,
  "data": {
    "network": "linkedin",
    "expiresAt": 1734567890000,
    "availablePages": [
      {
        "id": "abc123",
        "type": "organization",
        "name": "Acme Inc",
        "username": "acme-inc",
        "profilePictureUrl": "https://example.com/profile.jpg",
        "category": "Real Estate Agent",
        "urn": "urn:li:organization:12345",
        "accountId": "accounts/1234567890",
        "address": "12 Example St, Sydney NSW 2000"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.