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

200application/json

404application/json

500application/json

JavaScript

Go

Java

C#

cURL

TypeScript

Python

Swift

fetch(" {
  method: "GET"
})

200404500

{
  "success": true,
  "data": {
    "network": "linkedin",
    "expiresAt": 1734567890000,
    "availablePages": [\
      {\
        "id": "abc123",\
        "type": "organization",\
        "name": "Acme Inc",\
        "username": "acme-inc",\
        "profilePictureUrl": "
      }\
    ]
  }
}

{
  "success": false,
  "error": "Session expired or invalid"
}

{
  "success": false,
  "error": "Internal server error",
  "message": "Database connection failed"
}

Get social network authentication URL POST\ \ Previous Page Finalize pending connection POST\ \ Next Page