Get Available Accounts (Step 2 of 3)
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
- Start OAuth → User authenticates, returns
accountId - Get Accounts (this endpoint) → Lists available pages/channels to connect
- Attach Account → Connect the selected account
What This Returns
The response varies by platform:
| Platform | Returns |
|---|---|
| List of Facebook Pages the user manages | |
| List of Instagram Professional Accounts (linked to Facebook Pages) | |
| Google Business Profile locations | |
| LinkedIn Pages and Profile | |
| tiktok | TikTok Creator account info |
| tiktok-business | TikTok Business Center accounts |
| youtube | YouTube Channels |
| 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}
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your access token.
socialplanner/ oauth. readonlyOAuthPrivate IntegrationSub-Account TokenRequest
Headers
API Version
v3v3Path Parameters
Social media platform. Must match the platform used in the preceding steps of the OAuth flow.
googlefacebookinstagramthreadsblueskylinkedintiktoktiktok-businessyoutubepinterestfacebookThe Location ID where you want to connect this social account
w37swmmLbA02zgqKPpxITe2The OAuth Account ID received from Step 1 (Start OAuth) via the window message event
w37swmmLbA02zgqKPpxITeQuery Parameters
Search term to filter accounts/pages by name. Useful when the user has many pages to choose from.
page nameResponse
Returns available accounts/pages/channels that can be connected. Response structure varies by platform - see examples below.
- Tiktok Business
- Google Business Account
- Threads
- YouTube
- Bluesky
- Tiktok
Whether the page lookup completed without an upstream API error
trueStatus Code
200Message
Fetched Facebook AccountThe Facebook Pages available to connect. See GetFacebookAccountsSchema for the full field breakdown.