Skip to main content
GHL MCP Guide
SAC

Social Accounts

Social Media · Intermediate · Updated March 2026

Manage connected social media accounts, initiate OAuth connections, and retrieve platform-specific account details for multi-channel posting.

Before you can post to any social platform, you need a connected account. Social Accounts manages the OAuth connections between GHL and Facebook, Instagram, Twitter/X, LinkedIn, Google Business Profile, and TikTok. Through MCP, you can list connected accounts, initiate new connections, retrieve account details, and disconnect accounts.

What This MCP Tool Does

List all connected social media accounts for a location, retrieve platform-specific account details, start OAuth connection flows for new platforms, and disconnect accounts that are no longer needed. The account IDs from this tool are required by Social Post CRUD to specify where posts should be published.

Endpoint Reference

List all accounts: GET /social-media-posting/accounts Get accounts by platform: GET /social-media-posting/accounts/{platform} Start OAuth connection: POST /social-media-posting/oauth/start Disconnect an account: DELETE /social-media-posting/account/{accountId}

Authentication

Requires a Private Integration Token (PIT) with the social-media-posting scope enabled.

Key Parameters

  • platform — facebook, instagram, twitter, linkedin, gmb, tiktok
  • accountId — unique identifier for the connected account

Important Notes

OAuth connections require a browser-based authentication flow. The oauth/start endpoint initiates the flow and returns a URL the user must visit to authorize the connection. This is inherently interactive — it can’t be fully automated.

Account tokens can expire. If a social account stops working (posts fail), the OAuth connection may need to be re-established. Monitor post failures through Social Post Search to catch disconnections early.

Each platform has its own OAuth requirements and token lifetimes. Facebook/Instagram tokens are typically long-lived but can be revoked. Google Business Profile connections depend on Google account access.

Common Questions

Can I connect accounts programmatically without a browser? No. OAuth requires browser-based user authorization. MCP can initiate the flow but can’t complete it without user interaction.

How do I know which account ID to use when posting? List accounts and match on platform and account name. The response includes account IDs, platform identifiers, and display names.

What happens when a token expires? Posts to that account will fail. Re-initiate the OAuth flow to refresh the connection.

Back to GHL MCP Guide