Skip to main content
OAuth | GenericVersion: v3

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}

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:socialplanner/oauth.readonly
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3
Example:v3

Path Parameters

platformstringrequired

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

Available optionsgooglefacebookinstagramthreadsblueskylinkedintiktoktiktok-businessyoutubepinterest
Example:facebook
locationIdstringrequired

The Location ID where you want to connect this social account

Example:w37swmmLbA02zgqKPpxITe2
accountIdstringrequired

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

Example:w37swmmLbA02zgqKPpxITe

Query Parameters

searchstring

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

Example:page name

Response

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

oneOf
successbooleanrequired

Whether the page lookup completed without an upstream API error

Example:true
statusCodenumberrequired

Status Code

Example:200
messagestringrequired

Message

Example:Fetched Facebook Account
resultsobject

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