# Publora API & MCP Documentation > Publora is a social media scheduling and publishing platform with a REST API and an MCP server. One integration publishes to LinkedIn, X (Twitter), Facebook, Instagram, Threads, TikTok, YouTube, Bluesky, Mastodon, and Telegram; Pinterest is connect-only and not publishable. REST base URL: https://api.publora.com/api/v1; authenticate with `x-publora-key: sk_YOUR_API_KEY`. MCP endpoint: https://mcp.publora.com; authenticate with `Authorization: Bearer sk_YOUR_API_KEY`. Each link below points to the clean Markdown source of a page. For the entire documentation concatenated into one file, fetch https://docs.publora.com/llms-full.txt. ## Overview - [Getting Started](https://docs.publora.com/raw/getting-started): Publora API lets you schedule and publish social media posts across 10 platforms from a single REST endpoint. Base URL:… - [Authentication](https://docs.publora.com/raw/authentication): Publora uses API keys for authentication. API keys are long-lived credentials that don't expire or require refresh toke… - [Changelog](https://docs.publora.com/raw/changelog): This page records externally relevant REST and MCP contract changes. Dates are deployment or documentation publication… ## API Endpoints - [Create Post](https://docs.publora.com/raw/endpoints/create-post): Schedule or immediately queue a post across multiple social media platforms. - [Get Post](https://docs.publora.com/raw/endpoints/get-post): Retrieve details and publishing status of a post group. - [Update Post](https://docs.publora.com/raw/endpoints/update-post): Edit an existing draft or scheduled post in place — its base text, its target accounts, its scheduling time, its status… - [Delete Post](https://docs.publora.com/raw/endpoints/delete-post): Delete a post across all platforms where it was created. This endpoint removes the entire post group and all associated… - [Upload Media](https://docs.publora.com/raw/endpoints/upload-media): Upload images, videos, or PDF documents to attach to posts. Uses pre-signed S3 URLs for direct uploads. - [Attach Media](https://docs.publora.com/raw/endpoints/attach-media): Attach one image or video to an existing draft or scheduled post by passing a file reference: an HTTPS download URL plu… - [Upload Instagram Cover](https://docs.publora.com/raw/endpoints/upload-instagram-cover): Upload a custom cover image for an Instagram Reel. Publora hosts the image and returns a public URL you set as platform… - [Upload YouTube Thumbnail](https://docs.publora.com/raw/endpoints/upload-youtube-thumbnail): Upload a custom thumbnail for a YouTube video post. Publora stores the image as tracked media and returns a mediaId + u… - [Platform Connections](https://docs.publora.com/raw/endpoints/platform-connections): List all connected social media accounts. - [Platform Limits](https://docs.publora.com/raw/endpoints/platform-limits): Return Publora's per-platform posting limits (character counts, image / video / document / GIF / thumbnail rules, and p… - [Account Context](https://docs.publora.com/raw/endpoints/account-context): Read the plan, available features, publishing quotas, schedule horizon and allowed platforms of the account behind your… - [List Posts](https://docs.publora.com/raw/endpoints/list-posts): Retrieve a paginated list of all your scheduled, draft, published, and failed posts. - [Mastodon & Bluesky Statistics](https://docs.publora.com/raw/endpoints/platform-statistics): Engagement counters for published Mastodon and Bluesky posts, and follower counts for the connected accounts. Values ar… - [LinkedIn Statistics](https://docs.publora.com/raw/endpoints/linkedin-statistics): Retrieve analytics for your LinkedIn posts: impressions, reach, reactions, comments, and reshares. - [LinkedIn Reactions](https://docs.publora.com/raw/endpoints/linkedin-reactions): Add or remove reactions on LinkedIn posts programmatically. - [LinkedIn Followers](https://docs.publora.com/raw/endpoints/linkedin-followers): Retrieve follower statistics for your LinkedIn account, including total follower count and daily growth data. - [LinkedIn Profile Summary](https://docs.publora.com/raw/endpoints/linkedin-profile-summary): Retrieve a summary of your LinkedIn profile analytics including follower counts and aggregated post engagement metrics. - [LinkedIn Comments](https://docs.publora.com/raw/endpoints/linkedin-comments): Create and delete comments on LinkedIn posts programmatically. - [LinkedIn Reshare](https://docs.publora.com/raw/endpoints/linkedin-reshare): Reshare (repost) an existing LinkedIn post to your own feed, with optional commentary. Works for both personal profile… - [LinkedIn Mentionables](https://docs.publora.com/raw/endpoints/linkedin-mentionables): List the LinkedIn members you can @mention — a per-user directory of people whose native member ids Publora has capture… - [Post Logs](https://docs.publora.com/raw/endpoints/post-logs): Get detailed publish attempt history for a post group. Useful for debugging failed posts and understanding the publish… - [Test Connection](https://docs.publora.com/raw/endpoints/test-connection): Validate that a platform connection is working before scheduling posts. - [Webhooks](https://docs.publora.com/raw/endpoints/webhooks): Receive real-time post lifecycle notifications, including scheduled, published, failed, and demotion events. token.expi… ## Platform Guides - [LinkedIn](https://docs.publora.com/raw/platforms/linkedin): Post to LinkedIn programmatically using the Publora REST API. A simpler alternative to the LinkedIn Marketing API, Link… - [X (Twitter)](https://docs.publora.com/raw/platforms/x-twitter): Post to Twitter (X) programmatically using the Publora REST API. A simpler alternative to the official Twitter API v2,… - [Facebook](https://docs.publora.com/raw/platforms/facebook): Post to Facebook Pages programmatically using the Publora REST API. A simpler alternative to the Facebook Graph API or… - [Instagram](https://docs.publora.com/raw/platforms/instagram): Post to Instagram programmatically using the Publora REST API. A simpler alternative to the Instagram Graph API, Instag… - [Threads](https://docs.publora.com/raw/platforms/threads): Post to Threads (by Meta) programmatically using the Publora REST API. A simpler alternative to the official Threads AP… - [TikTok](https://docs.publora.com/raw/platforms/tiktok): Upload videos to TikTok programmatically using the Publora REST API. A simpler alternative to the official TikTok Devel… - [YouTube](https://docs.publora.com/raw/platforms/youtube): Upload videos to YouTube programmatically using the Publora REST API. A simpler alternative to the official YouTube Dat… - [Bluesky](https://docs.publora.com/raw/platforms/bluesky): Post to Bluesky programmatically using the Publora REST API. A simpler alternative to the AT Protocol (atproto) SDK or… - [Mastodon](https://docs.publora.com/raw/platforms/mastodon): Post to Mastodon and the Fediverse programmatically using the Publora REST API. A simpler alternative to the official M… - [Telegram](https://docs.publora.com/raw/platforms/telegram): Post to Telegram channels and groups programmatically using the Publora REST API. A simpler alternative to the Telegram… ## Guides - [MCP Server](https://docs.publora.com/raw/guides/mcp-server): Control Publora directly from AI assistants like Claude Code, Claude Desktop, Cursor, and any MCP-compatible client. No… - [Cross-Platform Posting](https://docs.publora.com/raw/guides/cross-platform): This guide covers how to publish a single post to multiple social media platforms simultaneously through the Publora AP… - [Scheduling Posts](https://docs.publora.com/raw/guides/scheduling): This guide covers how to schedule social media posts through the Publora API, including creating drafts, scheduling for… - [Bulk Scheduling](https://docs.publora.com/raw/guides/bulk-scheduling): Schedule multiple posts at once using batch operations, CSV imports, and content calendars. - [Media Uploads](https://docs.publora.com/raw/guides/media-uploads): This guide covers how to upload images, videos, and PDF document assets to Publora using pre-signed S3 URLs, and how to… - [Analytics](https://docs.publora.com/raw/guides/analytics): Track the performance of your LinkedIn posts with Publora's analytics endpoints. - [Error Handling](https://docs.publora.com/raw/guides/error-handling): This guide covers how to handle errors from the Publora API, including HTTP status codes, error response formats, retry… - [Error Code Catalog](https://docs.publora.com/raw/guides/error-codes): This catalog covers stable codes reachable through API-key-authenticated /api/v1 routes. It excludes internal X Bookmar… - [Rate Limits](https://docs.publora.com/raw/guides/rate-limits): This guide covers platform-specific rate limits, Publora API rate limits, and strategies for scheduling posts at optima… - [Platform Limits](https://docs.publora.com/raw/guides/platform-limits): This comprehensive guide documents the limits for all 10 social media platforms supported by Publora. Understanding the… - [Validation](https://docs.publora.com/raw/guides/validation): This guide covers how Publora validates posts before scheduling to prevent publish failures, including what gets valida… - [Threading](https://docs.publora.com/raw/guides/threading): Learn how to post connected threads to Twitter/X and Meta Threads. Both platforms accept one content field and publish… - [Twitter Threads](https://docs.publora.com/raw/guides/twitter-threads): Post tweet threads (tweetstorms) to X/Twitter programmatically using the Publora REST API. A simpler alternative to man… - [Threads Multi-Post](https://docs.publora.com/raw/guides/threads-multi-post): Publish a connected chain of Meta Threads posts from one API call. Publora creates each container, publishes it, and li… - [LinkedIn Comments](https://docs.publora.com/raw/guides/linkedin-comments): Post comments on LinkedIn posts programmatically using the Publora API. Engage with your network automatically without… - [LinkedIn Mentions](https://docs.publora.com/raw/guides/linkedin-mentions): Create LinkedIn posts that @mention people and organizations using the Publora API. Mentions become clickable links and… - [LinkedIn Reactions](https://docs.publora.com/raw/guides/linkedin-reactions): Add reactions (like, insightful, love, etc.) to LinkedIn posts programmatically using the Publora API. - [LinkedIn Analytics](https://docs.publora.com/raw/guides/linkedin-analytics): Get engagement metrics (impressions, reactions, comments, shares) for your LinkedIn posts using the Publora API. - [List Connected Accounts](https://docs.publora.com/raw/guides/list-connected-accounts): List all connected social media accounts for a user, including token health status and platform metadata. - [Agency First Comment](https://docs.publora.com/raw/guides/agency-first-comments): Agency Workspace posts support one text comment under the Company's own - [Agency Platform Settings](https://docs.publora.com/raw/guides/agency-platform-settings): Agency client posts use the Company API at https://api.publora.com/api/v1/company - [Agency Webhooks](https://docs.publora.com/raw/guides/agency-webhooks): Use the Company surface, not the personal /webhooks endpoints. - [Update Scheduled Post](https://docs.publora.com/raw/guides/update-scheduled-post): Update the text, target accounts, timing, or status of an already-scheduled post using the Publora API. This guide cove… - [Delete Scheduled Post](https://docs.publora.com/raw/guides/delete-scheduled-post): Delete a scheduled post from Twitter, LinkedIn, Instagram, Threads, and any other platforms where it was scheduled—all… - [Workspace / B2B](https://docs.publora.com/raw/guides/workspace): This guide covers how to use the Publora Workspace API to manage multiple users under your account. This is designed fo… - [Cursor AI Integration](https://docs.publora.com/raw/guides/cursor-ai): Get the most out of AI-assisted development when building with the Publora API. ## Code Examples - [JavaScript](https://docs.publora.com/raw/examples/javascript/quick-start): JavaScript syntax for the five Core Workflows. That page owns request ordering, response semantics, and upload behavior. - [JS: Media Upload](https://docs.publora.com/raw/examples/javascript/media-upload): Upload images and videos to Publora using the pre-signed URL workflow. - [JS: Scheduling Workflows](https://docs.publora.com/raw/examples/javascript/scheduling-workflows): Advanced scheduling patterns for automating your social media content. - [TypeScript](https://docs.publora.com/raw/examples/typescript/quick-start): TypeScript syntax for the five Core Workflows. Keep generated or application-specific types local; the canonical workfl… - [Python](https://docs.publora.com/raw/examples/python/quick-start): Python syntax for the five Core Workflows. The canonical page owns the API semantics. - [Python: Bulk CSV Import](https://docs.publora.com/raw/examples/python/bulk-csv-import): Schedule multiple posts from a CSV file using Python. - [PHP](https://docs.publora.com/raw/examples/php/quick-start): PHP syntax for the five Core Workflows. That page is the semantic source of truth. - [Ruby](https://docs.publora.com/raw/examples/ruby/quick-start): Ruby syntax for the five Core Workflows. The canonical page owns the API semantics. - [Go](https://docs.publora.com/raw/examples/go/quick-start): Go syntax for the five Core Workflows. The canonical page owns ordering and API semantics. - [Core Workflows](https://docs.publora.com/raw/examples/curl/all-endpoints): This page is the canonical request-flow reference for Publora examples. Language and framework guides provide syntax an… ## Framework Examples - [Next.js](https://docs.publora.com/raw/examples/frameworks/nextjs): This guide covers server-only App Router integration. The five supported example flows and their request semantics live… - [Laravel](https://docs.publora.com/raw/examples/frameworks/laravel): This guide covers Laravel-specific configuration, HTTP calls, queues, and webhook handling. Request semantics are owned… - [Django](https://docs.publora.com/raw/examples/frameworks/django): This guide covers Django-specific configuration and background jobs. Request semantics are single-sourced in Core Workf… ## MCP Integration - [Client Setup](https://docs.publora.com/raw/mcp/client-setup): Detailed setup instructions for connecting Publora MCP to different AI clients. - [Tools Reference](https://docs.publora.com/raw/mcp/tools-reference): Publora exposes 20 personal tools + 48 Company tools (68 total). This page documents the personal tools with parameters… - [Examples](https://docs.publora.com/raw/mcp/examples): Real-world examples of using Publora MCP with AI assistants like Claude, Cursor, and others. - [Grok Bot](https://docs.publora.com/raw/mcp/grok-bot): Connect Grok Bot to Publora and let it draft, schedule and publish your social media posts. You connect it once, sign i… - [Manus](https://docs.publora.com/raw/mcp/manus): Connect Manus (autonomous web agent) to Publora and let it schedule and publish across your social platforms. - [OpenClaw](https://docs.publora.com/raw/mcp/openclaw): Connect OpenClaw (open-source autonomous AI agent) to Publora for multi-platform social media posting. - [Troubleshooting](https://docs.publora.com/raw/mcp/troubleshooting): Common issues and solutions for Publora MCP Server. ## No-Code Integrations - [Zapier](https://docs.publora.com/raw/examples/no-code/zapier-integration): Publora has a native Zapier app, so anything that can start a Zap can also publish to your social accounts. A new row i… - [Make (Integromat)](https://docs.publora.com/raw/examples/no-code/make-integration): Connect Publora to 1,000+ apps using Make's HTTP module. - [n8n](https://docs.publora.com/raw/examples/no-code/n8n-integration): Connect Publora to 400+ apps using n8n's HTTP Request node. ## Other - [Publora API Documentation](https://docs.publora.com/raw/README): Affordable REST API for scheduling and publishing social media posts across 10 platforms.