Social Post CRUD
Create, edit, retrieve, and delete social media posts across Facebook, Instagram, Twitter, LinkedIn, GMB, and TikTok via MCP.
Social media is where visibility starts for most businesses. Creating and scheduling posts across multiple platforms is a daily operation for agency teams. Managing social posts through MCP means you can build automated content pipelines, schedule posts from external content systems, and manage multi-platform publishing without logging into GHL’s social planner.
What This MCP Tool Does
Full CRUD on social media posts. Create posts for Facebook, Instagram, Twitter/X, LinkedIn, Google Business Profile, and TikTok. Edit existing posts, retrieve post details, and delete posts. Supports scheduling for future publication and multi-platform posting in a single call.
Endpoint Reference
Create a post: POST /social-media-posting/post
Get a post: GET /social-media-posting/post/{postId}
Edit a post: PUT /social-media-posting/post/{postId}
Delete a post: DELETE /social-media-posting/post/{postId}
Authentication
Requires a Private Integration Token (PIT) with the social-media-posting scope enabled. Social accounts must be connected in the location.
Key Parameters
accountIds— array of connected social account IDs to post topost— the post content (text)mediaUrls— array of image or video URLs to includescheduleDate— ISO 8601 date for future publication (omit for immediate posting)tags— content organization tagscategoryId— content category for organization
Important Notes
Each platform has its own character limits, image specifications, and content rules. A post that works on LinkedIn might be too long for Twitter. MCP doesn’t enforce platform-specific limits — it sends your content and the platform accepts or rejects it.
Media URLs must be publicly accessible. Upload images to the Media Library first and use the returned URLs in your post requests.
Multi-platform posting sends the same content to all specified accounts. For platform-specific content variations, create separate posts for each platform.
Connected social accounts are managed through Social Accounts. You need the account IDs from that tool to specify where posts go.
Common Questions
Can I post to multiple platforms at once?
Yes. Include multiple account IDs in the accountIds array. The same content goes to each platform.
Can I schedule posts for the future?
Yes. Include a scheduleDate parameter. The post queues and publishes at the specified time.
Can I post different content to different platforms? Create separate post requests with different content and different account IDs.
Do I need to connect social accounts first? Yes. Use Social Accounts to initiate OAuth connections before posting.
Related MCP Tools
- Social Post Search — Find and filter existing posts
- Social Accounts — Manage connected social platform accounts
- Social Bulk Delete — Remove multiple posts at once
- Social CSV Import — Bulk-import posts from CSV files
- Media Library — Upload media for social posts