Skip to main content
OAuth | GenericVersion: v3

Connect Account (Step 3 of 3)

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

OAuth Connection Flow - Step 3: Connect the Account​

This is the final step in the OAuth flow. After retrieving available accounts (Step 2), use this endpoint to connect the selected account to your location.

OAuth Flow Summary​

  1. Start OAuth → User authenticates with platform
  2. Get Accounts → Retrieved available pages/channels
  3. Attach Account (this endpoint) → Connect the selected account

Request Body​

The accepted fields depend on the platform path parameter — pick the matching schema in the request body below. Most platforms take the originId, name and optional avatar of the account you selected in Step 2; Google Business Profile takes the full location and account objects.

tiktok-business accounts are connected through the TikTok Business flow, not this endpoint.

After Connection​

Once connected, the account will appear in your location's connected accounts and can be used for social media posting.

Authorizations

Authorizationstringheaderrequired

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

Scope:socialplanner/oauth.write
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

Body

The account to connect. The accepted fields depend on the platform path parameter.

oneOf
typestring

Type of Facebook account (must be page)

Available optionspagegroupprofilelocationbusiness
Example:page
originIdstring

Original Facebook platform identifier

Example:244405****11687
namestring

Name of the Facebook page or account

Example:JOHN_DEO
avatarstring

Avatar or profile picture URL

Example:https://storage.googleapis.com/2ad21ebc23/test

Response

Successful response - Account attached. Response structure varies by platform.

oneOf
successbooleanrequired

Whether the Facebook page was successfully attached to the requesting location

Example:true
statusCodenumberrequired

Status Code

Example:201
messagestringrequired

Human-readable message confirming the account was attached

Example:Added Facebook Account
resultsobject

The connected account record created (or updated) for the page that was just attached.