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: This endpoint uses the session token from the URL path for authentication instead of API keys. The session token is provided in the OAuth callback redirect.

Flow:

  1. User completes OAuth authentication
  2. Callback redirects to your page with ?session=xxx
  3. Call this endpoint to get available pages
  4. User selects which pages to connect
  5. Call POST /finalize to complete the connection
GET/v1/social-accounts/pending/{sessionToken}

Path Parameters

sessionTokenstring

Response Body

curl -X GET "https://api.outstand.so/v1/social-accounts/pending/string"
{
  "success": true,
  "data": {
    "network": "linkedin",
    "expiresAt": 1734567890000,
    "availablePages": [
      {
        "id": "abc123",
        "type": "organization",
        "name": "Acme Inc",
        "username": "acme-inc",
        "profilePictureUrl": "https://example.com/profile.jpg"
      }
    ]
  }
}
{
  "success": false,
  "error": "Session expired or invalid"
}
{
  "success": false,
  "error": "Internal server error",
  "message": "Database connection failed"
}