Pending Connections

Finalize pending connection

Complete the OAuth connection by selecting which pages/accounts to connect. This endpoint creates the social account records for the selected pages.

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. Call this from your backend.

Flow:

  1. Call GET /pending/:sessionToken to get available pages
  2. User selects which pages to connect
  3. Call this endpoint with the selected page IDs
  4. Social accounts are created and returned

Note: The session is automatically deleted after successful finalization.

post/v1/social-accounts/pending/{sessionToken}/finalize

Request

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

Path parameters

sessionTokenstring required

Request body

selectedPageIdsstring[] required

Array of page IDs to connect

Example request

{
  "selectedPageIds": [
    "abc123",
    "org456"
  ]
}

Response

Connection finalized successfully

successboolean required

Example response

{
  "success": true,
  "connectedAccounts": [
    {
      "id": "9dyJS",
      "nickname": "johndoe",
      "username": "johndoe",
      "network": "linkedin",
      "accountType": "personal"
    }
  ]
}

Changes

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