# PostEverywhere for Developers **Source:** https://posteverywhere.ai/developers --- REST API v1Updated 2026-06-11: 13 new endpoints, webhooks, MCP server # PostEverywhere for Developers [Schedule posts](https://posteverywhere.ai/social-media-scheduler), upload media, and publish to **11 platforms** with a single REST API. 29 endpoints, webhooks, campaigns, bulk operations, and an official MCP server. Automate your entire [social media workflow](https://posteverywhere.ai/social-media-automation) programmatically. Included on [all plans](https://posteverywhere.ai/pricing) from $29/mo. [Get your API key](https://app.posteverywhere.ai/signup)[Read the docs](https://developers.posteverywhere.ai)Used by **2,831+** happy customers Zero breaking changes The 2026-06-11 release adds 13 new endpoints, webhooks, campaigns, bulk operations, and an MCP server. Every existing integration continues to work without modification. New capabilities are additive and opt-in. Official packagesMIT license[@posteverywhere/sdk](https://www.npmjs.com/package/@posteverywhere/sdk)Node.js SDK · v1.4.0`npm install @posteverywhere/sdk@latest`[@posteverywhere/mcp](https://www.npmjs.com/package/@posteverywhere/mcp)MCP server · v1.4.1 · 33 tools`npx -y @posteverywhere/mcp`[@posteverywhere/cli](https://www.npmjs.com/package/@posteverywhere/cli)CLI · v0.2.1`npm install -g @posteverywhere/cli`Create & schedule a postcurl`curl -X POST https://app.posteverywhere.ai/api/v1/posts \ -H "Authorization: Bearer pe_live_your_key_here" \ -H "Content-Type: application/json" \ -d '{ "content": "Launching our new feature today!", "account_ids": [1, 2, 3], "scheduled_for": "2026-03-15T14:00:00Z", "timezone": "America/New_York" }'` ## What you can build with the PostEverywhere API 29 endpoints across posts, accounts, media, AI, webhooks, campaigns, and analytics, everything you need to automate social media. [](https://developers.posteverywhere.ai)POST ### Schedule & Publish Posts Create, schedule, and publish posts to 11 platforms with a single [social media API](https://posteverywhere.ai/social-media-api) call. Powers our [social media scheduler](https://posteverywhere.ai/social-media-scheduler) and supports [bulk scheduling](https://posteverywhere.ai/bulk-scheduling), set times, target specific accounts, and attach media. [](https://developers.posteverywhere.ai)POST ### Upload & Manage Media Two upload paths: a one-call `/media/upload-from-url` for any public image (25 MB cap), or the 3-step presigned flow for local files and video. Automatic processing and optimisation for each platform. Pair with the [AI image generator](https://posteverywhere.ai/ai-image-generator) for on-demand visuals. [](https://developers.posteverywhere.ai)POST ### Multi-Platform in One Call Publish to Instagram, X, LinkedIn, Facebook, TikTok, YouTube, Threads, Pinterest, Bluesky, Discord, and Telegram simultaneously from one endpoint. True [cross-posting](https://posteverywhere.ai/cross-posting), [post to all platforms at once](https://posteverywhere.ai/post-to-all-social-media-at-once) via API. [](https://developers.posteverywhere.ai)POST ### Webhooks Subscribe to 12 event types (`post.published`, `post.failed`, `account.reconnect_needed`, and more) instead of polling. Deliveries are signed with HMAC-SHA256 ([RFC 6234](https://datatracker.ietf.org/doc/html/rfc6234)) and retried with exponential backoff. [](https://developers.posteverywhere.ai)POST ### Campaigns Group posts into named campaigns (Q3 Launch, Holiday 2026) via full CRUD API. Filter posts by `campaign_id` to report on rollouts and align with your [social media calendar](https://posteverywhere.ai/social-media-calendar). [](https://developers.posteverywhere.ai)POST ### Bulk Operations Create up to 50 posts in one call. Bulk retry failed destinations by filter (platform, account, time window). Ideal for [multi-account management](https://posteverywhere.ai/multi-account-management) and high-volume [bulk scheduling](https://posteverywhere.ai/bulk-scheduling). [](https://developers.posteverywhere.ai)GET ### Monitor Results & Retry Get per-platform publishing results with URLs, errors, and attempt counts. Feed data into your [analytics](https://posteverywhere.ai/social-media-analytics) pipeline or retry failed destinations automatically. [](https://developers.posteverywhere.ai)GET ### Account Health Monitoring The `/accounts/:id/health` pre-flight check returns `can_post`, token state, and reasons[]. Track connected account health, token expiry, and posting capability across all platforms in real time. [](https://developers.posteverywhere.ai)POST ### AI Image Generation Generate social media images from text prompts using our [AI image generator](https://posteverywhere.ai/ai-image-generator). 4 models, 7 aspect ratios. Pair with the [AI content generator](https://posteverywhere.ai/ai-content-generator) for fully automated posts. [](https://developers.posteverywhere.ai)POST ### AI Caption Generation Generate 1 to 5 caption variants tuned per-platform (respects character limits and hashtag conventions). Companion to AI image generation. Powers our [AI content generator](https://posteverywhere.ai/ai-content-generator). [](https://developers.posteverywhere.ai)GET ### Introspection (/me) Discover org, plan, quota, and scopes in one call. SDKs self-configure without hardcoded IDs. Useful for SaaS builders, agencies, and white-label tools. [](https://developers.posteverywhere.ai)GET ### Analytics Summary Aggregate counters by period (today, week, month, custom). One call instead of listing every post. Feed straight into your [analytics](https://posteverywhere.ai/social-media-analytics) dashboards. [](https://developers.posteverywhere.ai) ### Secure Bearer Auth Simple API key authentication with scoped permissions (read/write/ai). Rate limit headers on every response. Model Context Protocol ## Use PostEverywhere with Claude (MCP) PostEverywhere ships an official [Model Context Protocol](https://modelcontextprotocol.io) server with 33 tools that Claude Code, Claude Desktop, Cursor, Cline, Windsurf, and Zed can use directly. Connect to the hosted endpoint at `https://mcp.posteverywhere.ai` with nothing to install, or run the open-source [@posteverywhere/mcp](https://www.npmjs.com/package/@posteverywhere/mcp) (v1.4.1, source on [GitHub](https://github.com/posteverywhere/mcp)) on your own machine. Either way, connect once, then ask the agent to schedule posts, retry failures, or build webhook subscriptions in natural language. Claude CodeClaude DesktopCursorClineWindsurfZed[Read the setup guide](https://posteverywhere.ai/blog/how-to-use-posteverywhere-with-claude-code-mcp)[Config blocks for Cursor, Codex CLI, Windsurf, and Zed](https://posteverywhere.ai/agents)Hosted · recommendedAdd to Claude Code, nothing to install `claude mcp add --transport http posteverywhere \ https://mcp.posteverywhere.ai \ --header "Authorization: Bearer pe_live_YOUR_KEY"`For any client that supports a remote HTTP MCP server: use URL `https://mcp.posteverywhere.ai` with header `Authorization: Bearer pe_live_YOUR_KEY`. The hosted server stores nothing: your key is passed straight through to the PostEverywhere API on every request, which enforces the same authentication, tenancy, and rate limits as a direct API call. Prefer to run it locally? Run with npx (on your machine) `npx -y @posteverywhere/mcp`Or add the local server to Claude Code `claude mcp add --scope user \ --env POSTEVERYWHERE_API_KEY=pe_live_YOUR_KEY \ -- posteverywhere npx -y @posteverywhere/mcp`Node.js SDK v1.4.0 ## @posteverywhere/sdk The official Node.js SDK wraps every endpoint with typed resources: `client.posts`, `client.media`, `client.accounts`, `client.ai`, `client.campaigns`, `client.webhooks`, `client.analytics`, and `client.me`. Automatic retries, rate-limit aware, full TypeScript types. [View on npm](https://www.npmjs.com/package/@posteverywhere/sdk)[Source on GitHub](https://github.com/posteverywhere/sdk)Install `npm install @posteverywhere/sdk@latest`Initialise `import { PostEverywhere } from '@posteverywhere/sdk' const client = new PostEverywhere({ apiKey: process.env.PE_API_KEY, }) const me = await client.me.get()`Webhooks + campaigns `// Subscribe to publish events const hook = await client.webhooks.create({ url: 'https://api.example.com/pe', events: ['post.published', 'post.failed'], }) // Group posts into a campaign const campaign = await client.campaigns.create({ name: 'Q3 Launch', }) // Aggregate counters in one call const summary = await client.analytics.summary({ period: 'week', })` ## PostEverywhere API endpoints 29 endpoints, grouped by resource. Introspection1 endpoint[GET`/me`Introspect API key context, org, plan, quota, scopes](https://developers.posteverywhere.ai)Accounts3 endpoints[GET`/accounts`List connected social media accounts](https://developers.posteverywhere.ai)[GET`/accounts/{id}`Get account details & health status](https://developers.posteverywhere.ai)[GET`/accounts/{id}/health`Pre-flight check: can_post, token state, reasons[]](https://developers.posteverywhere.ai)Posts9 endpoints[POST`/posts`Create & schedule a post](https://developers.posteverywhere.ai)[GET`/posts`List posts with filtering & pagination](https://developers.posteverywhere.ai)[GET`/posts/{id}`Get post details & destinations](https://developers.posteverywhere.ai)[PATCH`/posts/{id}`Update a scheduled or draft post](https://developers.posteverywhere.ai)[DELETE`/posts/{id}`Delete a scheduled or draft post](https://developers.posteverywhere.ai)[GET`/posts/{id}/results`Get per-platform publishing results](https://developers.posteverywhere.ai)[POST`/posts/{id}/retry`Retry failed platform destinations](https://developers.posteverywhere.ai)[POST`/posts/bulk`Create up to 50 posts in one call](https://developers.posteverywhere.ai)[POST`/posts/retry-failed`Bulk retry by filter (platform, account, time window)](https://developers.posteverywhere.ai)Media6 endpoints[POST`/media/upload-from-url`Import an image from a public URL in one call (≤25 MB)](https://developers.posteverywhere.ai)[POST`/media/upload`Start 3-step presigned upload (local files, video, >25 MB)](https://developers.posteverywhere.ai)[POST`/media/{id}/complete`Finalise a presigned upload](https://developers.posteverywhere.ai)[GET`/media`List media files](https://developers.posteverywhere.ai)[GET`/media/{id}`Get media details](https://developers.posteverywhere.ai)[DELETE`/media/{id}`Delete a media file](https://developers.posteverywhere.ai)AI2 endpoints[POST`/ai/generate-image`Generate an AI image from a text prompt](https://developers.posteverywhere.ai)[POST`/ai/generate-caption`Generate platform-tuned caption variants](https://developers.posteverywhere.ai)Campaigns5 endpoints[GET`/campaigns`List campaigns](https://developers.posteverywhere.ai)[POST`/campaigns`Create a campaign](https://developers.posteverywhere.ai)[GET`/campaigns/{id}`Get campaign details](https://developers.posteverywhere.ai)[PATCH`/campaigns/{id}`Update a campaign](https://developers.posteverywhere.ai)[DELETE`/campaigns/{id}`Delete a campaign (posts survive)](https://developers.posteverywhere.ai)Webhooks6 endpoints[GET`/webhooks`List webhook subscriptions](https://developers.posteverywhere.ai)[POST`/webhooks`Subscribe (secret returned once)](https://developers.posteverywhere.ai)[GET`/webhooks/{id}`Get subscription details](https://developers.posteverywhere.ai)[PATCH`/webhooks/{id}`Update url, events, active](https://developers.posteverywhere.ai)[DELETE`/webhooks/{id}`Delete a subscription](https://developers.posteverywhere.ai)[POST`/webhooks/{id}/test`Send a synthetic test delivery](https://developers.posteverywhere.ai)Analytics1 endpoint[GET`/analytics/summary`Aggregate counters by period (status, platform, metrics)](https://developers.posteverywhere.ai) ## PostEverywhere API use cases From SaaS platforms to internal tools, developers use the PostEverywhere API to power social media workflows at any scale. ### SaaS Builders Embed [social media management](https://posteverywhere.ai/social-media-management) directly in your app. Let your users schedule posts without leaving your platform. Use `/me` to self-configure SDKs and `/webhooks` to react to publish events in real time. ### Agencies Automate client posting at scale with [team workspaces](https://posteverywhere.ai/team-workspaces) and [multi-account management](https://posteverywhere.ai/multi-account-management). Manage hundreds of accounts programmatically across all platforms, with campaigns to group rollouts and bulk endpoints to ship 50 posts at a time. See our [agency solutions](https://posteverywhere.ai/for/agencies) and [top agency tools](https://posteverywhere.ai/blog/best-social-media-tools-for-agencies). ### Internal Tools Build custom dashboards, approval workflows, and [analytics](https://posteverywhere.ai/social-media-analytics) pipelines on top of PostEverywhere. Integrate with our [social media calendar](https://posteverywhere.ai/social-media-calendar) for visual scheduling, then surface aggregate counters via `/analytics/summary`. ### Content Pipelines Connect RSS feeds, CMS systems, or AI generators to auto-publish content. Use [bulk scheduling](https://posteverywhere.ai/bulk-scheduling) and [social media automation](https://posteverywhere.ai/social-media-automation), plus webhook subscriptions to react when a post succeeds or fails. ## Get started with the PostEverywhere API in 3 steps 1 ### Get your API key Go to Settings > Developer in the PostEverywhere dashboard. API access is included on all plans. [Create API Key →](https://app.posteverywhere.ai/signup)2 ### Make your first request List your connected accounts to get account IDs, then create your first post. [Quick Start Guide →](https://developers.posteverywhere.ai)3 ### Check publishing results Monitor per-platform results, get published URLs, and retry any failed destinations. Subscribe to webhooks to react in real time. [Posts API Reference →](https://developers.posteverywhere.ai) ## PostEverywhere API included on all plans No separate API add-on. No enterprise-only gating. Every PostEverywhere plan includes full API access, webhooks, campaigns, bulk operations, and the MCP server. Starter $29/mo 10 accounts 100 AI credits/mo Full API access Unlimited posts Growth $39/mo 25 accounts 500 AI credits/mo Full API access Unlimited posts Pro $79/mo 40 accounts 2,000 AI credits/mo Full API access Unlimited posts [View full pricing →](https://posteverywhere.ai/pricing) ## PostEverywhere API rate limits WindowLimitHeaderGeneral APIPer minute60 requests`X-RateLimit-Limit`Per hour1,000 requests`X-RateLimit-Remaining`PostingPer minute20 posts`X-RateLimit-Limit`Per hour100 posts`X-RateLimit-Remaining`Per day500 posts`Retry-After`AI GenerationPer 5 minutes50 generations`X-RateLimit-Limit`Per hour200 generations`X-RateLimit-Remaining`WebhooksSubscriptions per org25 webhooksConfigured per organisationBulk operationsPosts per bulk call50 postsPOST /posts/bulkRate limit headers are included in every response. [Learn more →](https://developers.posteverywhere.ai/quick-start) ## PostEverywhere developer FAQ What is the PostEverywhere API?The PostEverywhere API is a REST API that lets you programmatically [schedule](https://posteverywhere.ai/social-media-scheduler) and publish social media posts across 11 platforms ([Instagram](https://posteverywhere.ai/instagram-scheduler), [X](https://posteverywhere.ai/x-scheduler), [LinkedIn](https://posteverywhere.ai/linkedin-scheduler), [Facebook](https://posteverywhere.ai/facebook-scheduler), [TikTok](https://posteverywhere.ai/tiktok-scheduler), [YouTube](https://posteverywhere.ai/youtube-scheduler), [Threads](https://posteverywhere.ai/threads-scheduler), Pinterest, Bluesky, Discord, and Telegram), upload media, manage connected accounts, subscribe to webhooks, group posts into campaigns, and monitor publishing results, all from a single integration with 29 endpoints.How do I get an API key?Go to Settings > Developer in the PostEverywhere dashboard. Click "Create API Key", name your key, select scopes (Read, Write, and/or AI), and copy the key. It starts with pe_live_ and should be stored securely.Is the API included in my plan?Yes. API access is included on all PostEverywhere plans, Starter ($29/mo), Growth ($39/mo), and Pro ($79/mo). There is no separate API add-on or enterprise-only gating. [View full pricing](https://posteverywhere.ai/pricing).Which platforms does the API support?The API supports all 11 platforms available in PostEverywhere: Instagram (posts, Reels, Stories, carousels), X (tweets, threads), LinkedIn (profiles, company pages), Facebook (pages, Reels), TikTok (videos), YouTube (videos, Shorts), Threads (text, images), Pinterest (pins), Bluesky (posts), Discord (channels), and Telegram (channels).Can I post to multiple platforms at once?Yes. When creating a post via POST /posts, pass multiple account IDs in the account_ids array. The API publishes to all specified platforms simultaneously from a single request.How do webhooks work?Subscribe to events with `POST /webhooks`, supplying a URL and an event list. We send signed JSON deliveries with an `X-PE-Signature` header (HMAC-SHA256 of the body using the secret returned at subscription time). 12 event types are supported, including `post.published`, `post.failed`, and `account.reconnect_needed`. Failed deliveries retry with exponential backoff. Each organisation can create up to 25 webhook subscriptions.What is the bulk post limit?You can create up to 50 posts per call via `POST /posts/bulk`. Each post in the batch is validated independently and reports its own success or failure in the response, so partial batches are reported cleanly. Use this for content pipelines, CMS imports, and large editorial rollouts.Does PostEverywhere have an MCP server?Yes, and you can connect to it two ways. The hosted server at `https://mcp.posteverywhere.ai` needs nothing installed: in Claude Code, run `claude mcp add --transport http posteverywhere https://mcp.posteverywhere.ai --header "Authorization: Bearer pe_live_YOUR_KEY"`. Or run the open-source server [@posteverywhere/mcp](https://www.npmjs.com/package/@posteverywhere/mcp) (v1.4.1) locally with `npx -y @posteverywhere/mcp`. Both expose 33 tools that Claude Code, Claude Desktop, Cursor, Cline, Windsurf, Zed, and any MCP-compatible AI coding agent can use directly to schedule posts, retry failures, or build webhook subscriptions in natural language. See the [setup guide](https://posteverywhere.ai/blog/how-to-use-posteverywhere-with-claude-code-mcp).Can I retry failed posts in bulk?Yes. `POST /posts/retry-failed` retries failed destinations by filter (platform, account, time window). Use this after fixing a token issue, restoring an account, or recovering from a platform outage, rather than retrying posts one at a time. For a single post, `POST /posts/{id}/retry` retries only the failed destinations.What does /me return?`GET /me` returns the API key context in one call: the organisation, the plan tier, current quota usage (posts, AI credits, accounts), the scopes granted to the key, and feature flags. SDKs use this to self-configure without hardcoded IDs, and white-label tools use it to render plan-aware UI.What are the rate limits?API requests are rate-limited to 60 requests per minute and 1,000 per hour per API key. Rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, Retry-After) are included in every response.Do you have official SDKs?We provide an official [Node.js SDK on npm](https://www.npmjs.com/package/@posteverywhere/sdk) (`npm install @posteverywhere/sdk@latest` for v1.4.0, source on [GitHub](https://github.com/posteverywhere/sdk)) and an [MCP server](https://www.npmjs.com/package/@posteverywhere/mcp) (`@posteverywhere/mcp` v1.4.1, source on [GitHub](https://github.com/posteverywhere/mcp)) that works with any MCP-compatible AI coding agent, Claude Code, Cursor, Codex CLI, Windsurf, Cline, Zed, and more. We also publish code examples in cURL. The API follows REST conventions and works with any HTTP client in any language.Is there a command-line tool (CLI)?Yes. Install [@posteverywhere/cli](https://www.npmjs.com/package/@posteverywhere/cli) with `npm install -g @posteverywhere/cli` (v0.2.1) and post or schedule across all 11 platforms straight from your terminal. Run `posteverywhere login` once (a device-grant flow, like the GitHub CLI), then `posteverywhere connect instagram` and `posteverywhere post -c "Launch day" -a 123`. Every command also takes `--json`, so the CLI doubles as a tool your AI agents (Claude, Cursor) can call directly.Is there a sandbox or test mode?Currently, the API operates in production mode. We recommend creating a test organisation with sandbox social accounts for development. All API keys can be revoked instantly from Settings > Developer if needed.Can I use the API to build a white-label scheduler?Yes. Many agencies use the PostEverywhere API to build custom-branded scheduling tools for their clients. The API handles all platform authentication, media processing, and publishing, you build the UI. `GET /me` makes plan-aware rendering trivial. See our [agency solutions](https://posteverywhere.ai/for/agencies) for more details.How does AI image generation work via the API?Send a POST request to /ai/generate-image with a text prompt. The API uses our [AI image generator](https://posteverywhere.ai/ai-image-generator) to create visuals and saves them to your media library. Pair it with the [AI content generator](https://posteverywhere.ai/ai-content-generator) (or call `/ai/generate-caption` for platform-tuned text) for fully automated posts. Each generation uses 1 AI credit from your plan allowance.Can I automate posting from my CMS or blog?Yes. Use the POST /posts endpoint to auto-publish content whenever your CMS publishes. Common integrations include WordPress webhooks, Ghost, and Contentful. You can also use RSS-to-post workflows with tools like n8n or Zapier connected to our API. Subscribe to `post.published` webhooks to close the loop in your CMS. Learn more about [social media automation](https://posteverywhere.ai/social-media-automation).What happens if a post fails on one platform?The API publishes to each platform independently. If Instagram succeeds but TikTok fails (e.g., token expired), you get per-platform results showing exactly which destinations succeeded and which failed. Use `POST /posts/{id}/retry` to retry only the failed destinations without re-publishing to platforms that already succeeded, or `POST /posts/retry-failed` for bulk recovery by filter.Are there any breaking changes in this release?No. The 2026-06-11 release added 13 new endpoints, webhooks, campaigns, bulk operations, and an MCP server with zero breaking changes. Every existing integration continues to work without modification. New capabilities are additive and opt-in. ## Explore more [Social Media Scheduler](https://posteverywhere.ai/social-media-scheduler)[Social Media Management](https://posteverywhere.ai/social-media-management)[Social Media Automation](https://posteverywhere.ai/social-media-automation)[Social Media Calendar](https://posteverywhere.ai/social-media-calendar)[Social Media Analytics](https://posteverywhere.ai/social-media-analytics)[Instagram Scheduler](https://posteverywhere.ai/instagram-scheduler)[TikTok Scheduler](https://posteverywhere.ai/tiktok-scheduler)[LinkedIn Scheduler](https://posteverywhere.ai/linkedin-scheduler)[Facebook Scheduler](https://posteverywhere.ai/facebook-scheduler)[X Scheduler](https://posteverywhere.ai/x-scheduler)[YouTube Scheduler](https://posteverywhere.ai/youtube-scheduler)[Threads Scheduler](https://posteverywhere.ai/threads-scheduler)[AI Content Generator](https://posteverywhere.ai/ai-content-generator)[AI Image Generator](https://posteverywhere.ai/ai-image-generator)[Cross-Posting](https://posteverywhere.ai/cross-posting)[Bulk Scheduling](https://posteverywhere.ai/bulk-scheduling)[Multi-Account Management](https://posteverywhere.ai/multi-account-management)[Agency Solutions](https://posteverywhere.ai/for/agencies)[Social Media Agents](https://posteverywhere.ai/agents)[OpenClaw Integration](https://posteverywhere.ai/openclaw)[Pricing](https://posteverywhere.ai/pricing) ## Related guides [Best Social Media Scheduling Tools](https://posteverywhere.ai/blog/best-social-media-scheduling-tools)[Best Social Media Tools for Agencies](https://posteverywhere.ai/blog/best-social-media-tools-for-agencies)[Best AI Social Media Scheduling Tools](https://posteverywhere.ai/blog/best-ai-social-media-scheduling-tools)[Best Social Media Automation Tools](https://posteverywhere.ai/blog/best-social-media-automation-tools)[Best Bulk Scheduling Tools](https://posteverywhere.ai/blog/best-bulk-social-media-scheduling-tools)[Best Content Repurposing Tools](https://posteverywhere.ai/blog/best-content-repurposing-tools) ## Start building with PostEverywhere Get your API key, make your first request, and go live, all in under 5 minutes. See why PostEverywhere is one of the [best social media scheduling tools](https://posteverywhere.ai/blog/best-social-media-scheduling-tools). [Get API Key](https://app.posteverywhere.ai/signup)[Quick Start Guide](https://developers.posteverywhere.ai/quick-start)