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 by Platform​

The request body structure varies depending on the platform:

Facebook / Instagram​

{
  "type": "page",
  "originId": "244405XXXXX11687",
  "name": "My Facebook Page",
  "avatar": "https://..." // optional
}

Google Business Profile​

{
  "location": {
    "name": "locations/12345",
    "title": "My Business Location",
    "storeCode": "STORE123",
    "isVerified": "ChIJsZQpj1qbXjkRQNDUG4UUx6k"
  },
  "account": {
    "name": "accounts/12345",
    "accountName": "My Business Account",
    "type": "LOCATION_GROUP",
    "verificationState": "VERIFIED",
    "vettedState": "VETTED"
  }
}

LinkedIn​

{
  "type": "page",
  "originId": "urn:li:organization:12345",
  "name": "My LinkedIn Page",
  "avatar": "https://..." // optional
}

TikTok​

{
  "originId": "7234567890123456789",
  "name": "My TikTok Account",
  "avatar": "https://..." // optional
}

YouTube​

{
  "originId": "UCxxxxxxxxxxxxxxxx",
  "name": "My YouTube Channel",
  "avatar": "https://..." // optional
}

Pinterest​

{
  "originId": "123456789",
  "name": "My Pinterest Account",
  "avatar": "https://..." // optional
}

After Connection​

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

Request​

Authorization stringrequired

Access Token

Version stringrequired

API Version

Available optionsv3
locationId stringrequired

The Location ID where you want to connect this social account

platform stringrequired

Social media platform (must match the platform used in Steps 1 and 2)

Available optionsgooglefacebookinstagramlinkedintiktokyoutubepinterestthreadsbluesky
accountId stringrequired

The OAuth Account ID received from Step 1 (same as used in Step 2)

application/json

Bodyrequired

Account details to connect. The structure varies by platform - see description above for examples.

    oneOf
    typestringrequired

    Type of Facebook account (must be page)

    Available optionspage
    originIdstringrequired

    Original Facebook platform identifier

    namestringrequired

    Name of the Facebook page or account

    avatarstringrequired

    Avatar or profile picture URL

application/json

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

Schema
    oneOf
    successbooleanrequired

    Success or Failure

    statusCodenumberrequired

    Status Code

    messagestringrequired

    Message

    resultsobject

    Requested Results