Skip to content
Postly API

Build social publishing into your product, workflow, or AI stack

Postly API gives developers a direct way to create posts, upload media, schedule content, publish across channels, and retrieve performance data. MCP is available as the AI-agent layer for assistants that need scoped access to Postly actions.

Open API docsExplore MCP for AI agents
REST APIMedia uploadsSchedulingAnalyticsMCP-ready
API quick look
# Connect your product to Postly
POST /v1/posts
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "content": "Launching our new feature today!",
  "platforms": ["linkedin", "x"],
  "schedule_at": "2026-02-01T09:00:00Z"
}
Section 1

API access

The Postly API gives builders direct access to Postly publishing infrastructure. Use it for programmatic publishing, media management, campaign workflows, analytics, status checks, and custom automations.

Secure API access

Connect your app, workflow, or backend service to Postly with authenticated API requests.

Workspace-aware controls

Build against the correct workspace, social accounts, media library, campaigns, drafts, and publishing context.

Developer-first REST API

Create posts, upload media, schedule content, publish, retrieve analytics, and check status from your own systems.

Automation ready

Power CRMs, CMS tools, approval flows, internal dashboards, AI tools, and repeatable publishing automations.

Section 2

API use cases

Use the API when you want reliable server-to-server access to Postly from your own product, internal system, automation layer, or backend workflow.

Create and publish posts

Create content, select platforms, attach media, and publish immediately or schedule for later.

Upload media assets

Upload images and videos from files or URLs, then reuse returned media IDs in publishing requests.

Carousel and multi-image posts

Attach multiple media assets to one post for platforms that support carousel or multi-image publishing.

Campaign workflows

Plan, draft, schedule, organize, and monitor posts as part of repeatable campaign operations.

Analytics and reporting

Bring performance data, post status, and campaign reporting into your own product or dashboard.

AI-assisted publishing

Use the API behind copilots, content generators, internal AI tools, and structured publishing automations.

Section 3

MCP for AI agents

MCP gives AI clients a structured way to use Postly actions with permission-scoped tools. Developers can keep the REST API for direct integrations and send agent-focused users to the dedicated MCP page for setup, scopes, and examples.

Agent ready

Connect AI clients that can draft, schedule, publish, and retrieve status through Postly.

Scoped tools

Use focused permissions for drafts, media, scheduling, publishing, campaigns, and analytics.

Chat operations

Let users manage publishing tasks from a conversational interface while Postly handles execution.

View MCP pageOpen API docs

Supported AI clients and agents

ChatGPTClaudeCursorWindsurfOpenRouterHermesCabinetOpenClawNanoClawMulti-model AI gatewaysFuture MCP-compatible AI systems
Agent flow
# Use MCP when an AI client needs tools
User: Create a LinkedIn draft from this launch note.
Agent: Draft created in Postly and ready for review.

User: Schedule it for tomorrow at 9am.
Agent: Scheduled through Postly.
Section 4

MCP use cases

MCP is best for AI-native workflows where the user works through an assistant, copilot, agent, CLI, or multi-model interface instead of calling REST endpoints directly.

AI publishing assistant

Let an AI assistant help draft, schedule, publish, and check the status of social posts through Postly.

Campaign copilot

Plan campaigns, prepare variations, stage drafts, assign media, and organize publishing work from an AI client.

Analytics assistant

Answer performance questions with read-only analytics access while keeping publishing permissions separate.

Scoped agent actions

Grant only the tools each agent needs, such as drafts, media upload, scheduling, analytics, or publishing.

API for developers. MCP for agents.

Use the REST API for direct product integrations and backend workflows. Use MCP when an AI client needs tool-based access to Postly actions on behalf of a user.

Explore MCP docs

API guide library

10 guides available

Use this when a customer wants to publish several images under one post. Upload each image by file or URL first, then create the post with multiple file IDs.

Example
// Option 1: Upload images from files
POST /v1/files
Authorization: Bearer YOUR_API_KEY
Content-Type: multipart/form-data

file=@image1.jpg
file=@image2.jpg

// Example response
{
  "files": [
    { "id": "file_1" },
    { "id": "file_2" }
  ]
}


// Option 2: Upload an image from a public URL
POST /v1/files
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "url": "https://example.com/image1.jpg"
}

// Repeat for each URL and collect the returned file IDs.


// Create one post with multiple images
POST /v1/posts
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "content": "New collection from Asia Lifestyle Magazine",
  "platforms": ["instagram", "linkedin"],
  "media": [
    { "file_id": "file_1" },
    { "file_id": "file_2" }
  ]
}
Open API docs