Connect Account (Step 3 of 3)
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
- Start OAuth → User authenticates with platform
- Get Accounts → Retrieved available pages/channels
- 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-businessaccounts 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
Bearer authentication header of the form Bearer <token>, where <token> is your access token.
socialplanner/ oauth. writeOAuthPrivate 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
w37swmmLbA02zgqKPpxITeBody
The account to connect. The accepted fields depend on the platform path parameter.
- Google Business Account
- Threads
- Bluesky
- Tiktok
- YouTube
Type of Facebook account (must be page)
pagegroupprofilelocationbusinesspageOriginal Facebook platform identifier
244405****11687Name of the Facebook page or account
JOHN_DEOAvatar or profile picture URL
https://storage.googleapis.com/2ad21ebc23/testResponse
Successful response - Account attached. Response structure varies by platform.
- Tiktok Business
- Google Business Account
- Threads
- YouTube
- Tiktok
- Bluesky
Whether the Facebook page was successfully attached to the requesting location
trueStatus Code
201Human-readable message confirming the account was attached
Added Facebook AccountThe connected account record created (or updated) for the page that was just attached.