planpo.st
FeaturesFor AI agentsRevenue trackingPlatformsPricingBlogSupport
Sign inStart free trial →
planpo.st

Social scheduling with revenue built in. One platform for creators and businesses who treat social as a growth engine.

Product

SchedulerFor creatorsFor agenciesCompare toolsAlternativesPricing

Channels

InstagramLinkedInX (Twitter)ThreadsFacebookYouTubeTikTokAll channels →

AI agents

MCP serverFor AI agentsClaude CodeCursorChatGPTGemini CLIAll agents →

Revenue

Revenue trackingRevenue attributionStripeShopifyRevenueCatAll integrations →

Resources

DocsMCP toolsAPI referenceBlogAboutSupportContactPrivacyTerms

Compare planpo.st

  • planpo.st vs Postiz
  • planpo.st vs Buffer
  • planpo.st vs Hootsuite
  • planpo.st vs Later
  • planpo.st vs Sprout Social
  • planpo.st vs SocialBee
  • planpo.st vs Planable
  • planpo.st vs Metricool
  • planpo.st vs Loomly
  • planpo.st vs Publer
  • planpo.st vs Post Bridge
  • planpo.st vs Mixpost
  • planpo.st vs Blotato
  • planpo.st vs Typefully
  • planpo.st vs RecurPost
  • planpo.st vs Post Planner
  • All comparisons →
  • Alternatives →
© 2026 planpo.st · all rights reservedstatus: ● all systems normal
  1. Home
  2. /Docs
  3. /REST API
← Docs

REST API reference

60 endpoints for talking to planpo.st without MCP. Everything the agent tools do is available here too, because the MCP server is a client of this API.

Base URL and auth

Send your key as a bearer token, or in an X-API-Key header. Every response uses the envelope { success, data, message? }.

bash
curl https://api.planpo.st/api/public/v1/posts \
  -H "Authorization: Bearer pk_live_xxx"

Permissions

Keys are scoped. A request whose endpoint needs a permission the key does not carry is rejected, so grant the narrowest set that works.

approvals:readapprovals:writebrand-kits:readcarousels:readcarousels:writecontent-sources:readcontent-sources:writegroups:readgroups:writemedia:writeposts:readposts:writetrack:writevideos:readvideos:write

Endpoints

Paths are relative to https://api.planpo.st/api/public/v1.

Account groups

GET/account-groupsgroups:read
POST/account-groupsgroups:write
DELETE/account-groups/:groupIdgroups:write
PATCH/account-groups/:groupIdgroups:write
DELETE/account-groups/:groupId/connectionsgroups:write
POST/account-groups/:groupId/connectionsgroups:write
GET/account-groups/:idOrNamegroups:read
GET/account-groups/defaultgroups:read

Analytics

GET/analytics 

Approvals

GET/approvalsapprovals:read
POST/approvalsapprovals:write
GET/approvals/:approvalIdapprovals:read

Brand kits

GET/brand-kitsbrand-kits:read
GET/brand-kits/:idbrand-kits:read

Brand voice

GET/brand-voice 
GET/brand-voice/:id 
GET/brand-voice/:id/prompt 

Carousels

POST/carousels/generatecarousels:write
GET/carousels/optionscarousels:read
POST/carousels/rendercarousels:write
GET/carousels/render/:idcarousels:read

Connections

GET/connections 
GET/connections/connect-link 

Content sources

GET/content-sourcescontent-sources:read
POST/content-sourcescontent-sources:write
DELETE/content-sources/:idcontent-sources:write
GET/content-sources/:id/contentcontent-sources:read
POST/content-sources/:id/fetchcontent-sources:write

Images

POST/images/generate 
POST/images/generate-from-content 

Media

GET/media 
POST/media/upload-urlmedia:write

Posts and publishing

GET/postsposts:read
POST/postsposts:write
DELETE/posts/:idposts:write
GET/posts/:idposts:read
PUT/posts/:idposts:write
GET/posts/:id/previewposts:read
POST/posts/:id/publishposts:write
POST/posts/bulkposts:write
POST/posts/bulk-deleteposts:write
GET/posts/campaignsposts:read

Repurposing

POST/repurpose 

Revenue

GET/revenue/by-platform 
GET/revenue/connections 
GET/revenue/overview 
GET/revenue/rc-metrics 
GET/revenue/stripe-metrics 
GET/revenue/timeseries 
GET/revenue/top 
GET/revenue/transactions 

Smart schedule

GET/smart-schedule/best-times 
POST/smart-schedule/suggest 
GET/posting-queue/queuesschedule:read
GET/posting-queue/next-slotschedule:read
PUT/posting-queue/queues/:groupIdschedule:write

Video

POST/videos/rendervideos:write
GET/videos/render/:idvideos:read
GET/videos/rendersvideos:read
GET/videos/templatesvideos:read
MCP tool reference