Get Available Accounts (Step 2 of 3)

GET 
/social-media-posting/oauth/:locationId/:platform/accounts/:accountId

OAuth Connection Flow - Step 2: Get Available Accounts

After completing OAuth authentication (Step 1), use this endpoint to retrieve the list of available pages, channels, or locations that can be connected.

OAuth Flow Position

1. Start OAuth → User authenticates, returns accountId
2. Get Accounts (this endpoint) → Lists available pages/channels to connect
3. Attach Account → Connect the selected account

What This Returns

The response varies by platform:

Platform	Returns
facebook	List of Facebook Pages the user manages
instagram	List of Instagram Professional Accounts (linked to Facebook Pages)
google	Google Business Profile locations
linkedin	LinkedIn Pages and Profile
tiktok	TikTok Creator account info
tiktok-business	TikTok Business Center accounts
youtube	YouTube Channels
pinterest	Pinterest Business accounts and boards
threads	Threads profiles

Next Step

From the response, select the account/page you want to connect and use its details in Step 3:

POST /social-media-posting/oauth/{locationId}/{platform}/accounts/{accountId}

Request

Version stringrequired

API Version

Available optionsv3

platform stringrequired

Social media platform. Must match the platform used in the preceding steps of the OAuth flow.

Available optionsgooglefacebookinstagramthreadsblueskylinkedintiktoktiktok-businessyoutubepinterest

locationId stringrequired

The Location ID where you want to connect this social account

accountId stringrequired

The OAuth Account ID received from Step 1 (Start OAuth) via the window message event

search string

Search term to filter accounts/pages by name. Useful when the user has many pages to choose from.

application/json

Returns available accounts/pages/channels that can be connected. Response structure varies by platform - see examples below.

application/json

Schema

Schema

oneOf
• Facebook
• Tiktok Business
• Google Business Account
• Linkedin
• Instagram
• Threads
• YouTube
• Bluesky
• Tiktok
• Pinterest

successbooleanrequired

Whether the page lookup completed without an upstream API error

statusCodenumberrequired

Status Code

messagestringrequired

Message

resultsobject

The Facebook Pages available to connect. See GetFacebookAccountsSchema for the full field breakdown.

Example (auto)

{
  "success": true,
  "statusCode": 200,
  "message": "Fetched Facebook Account",
  "results": {
    "pages": [
      {
        "id": "u37swmmLbA02zgqKPpxITe2",
        "name": "FB Page",
        "isOwned": true,
        "isConnected": false
      }
    ]
  }
}