Skip to main content
Version: 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.

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

application/json

Bodyrequired

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

    oneOf
    typestring

    Type of Facebook account (must be page)

    Available optionspagegroupprofilelocationbusiness
    originIdstring

    Original Facebook platform identifier

    namestring

    Name of the Facebook page or account

    avatarstring

    Avatar or profile picture URL

application/json

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

Schema
    oneOf
    successbooleanrequired

    Whether the Facebook page was successfully attached to the requesting location

    statusCodenumberrequired

    Status Code

    messagestringrequired

    Human-readable message confirming the account was attached

    resultsobject

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