Skip to main content
Version: 2023-02-21

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:

PlatformReturns
facebookList of Facebook Pages the user manages
instagramList of Instagram Professional Accounts (linked to Facebook Pages)
googleGoogle Business Profile locations
linkedinLinkedIn Pages and Profile
tiktokTikTok Creator account info
tiktok-businessTikTok Business Center accounts
youtubeYouTube Channels
pinterestPinterest Business accounts and boards
threadsThreads 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

Responses

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