PostPiper

Social media scheduling API

Schedule posts from your code or your AI agent.

PostPiper provides a REST API to schedule and publish posts to X, LinkedIn, and Pinterest, plus an MCP server for AI agents and a terminal workflow with cURL.

Get your API keyRead the docs

30 free post credits. Pro from $10/mo for 1,000 posts.

YOUR FIRST SCHEDULED POSTcURL
Terminal
curl -X POST \
  "https://api.postpiper.ai/v1/posts/$POST_ID/schedule" \
  -H "Authorization: Bearer $POSTPIPER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scheduled_at": "2030-11-10T15:00:00Z"
  }'

Set POSTPIPER_API_KEY and POST_ID to your API key and draft ID. Replace the example date with a future UTC time.

Create a draft first →

Integrate your way

One platform, three interfaces.

REST API

Create, schedule, and list posts with plain JSON over HTTPS. Authenticate with a Bearer API key and schedule with ISO 8601 timestamps.

Explore the API

MCP server

Connect Claude, ChatGPT, Cursor, or another compatible MCP client with OAuth. Draft with your AI, then confirm before it goes out.

Connect your agent

CLI

Use cURL to draft and schedule from your terminal or a CI job. The same REST endpoints fit into your existing scripts and workflows.

Try the quickstart

API features

Your publishing workflow, one API.

Social media publishing

Publish posts to X, LinkedIn, and Pinterest through one REST API.

Schedule at the right time

Choose the best posting time for your audience and schedule posts with precise time zone control.

Upload images or import URLs

Upload images directly or import media from a public URL, ready to attach to your posts.

List connected accounts

Retrieve your connected social accounts and choose where each post gets published.

List scheduled posts

Fetch upcoming posts, filter by account or platform, and keep your publishing queue in sync.

How it works

From connected account to scheduled post.

01

Connect

Link a social account in your dashboard, create an API key, and get your connected account ID.

List connected accounts

02

Draft and review

Send your content and account_id to POST /posts. Review the draft and save the returned post.id.

Create a draft

03

Schedule

Send a future scheduled_at to the draft’s schedule endpoint. Track its status through the API or your calendar.

Schedule a post

FAQ

Common questions

Does PostPiper have a social media scheduling API?

Yes. PostPiper provides a REST API at https://api.postpiper.ai/v1. Create a draft with POST /posts, then schedule it with POST /posts/{postId}/schedule. You can also list posts, check their status, and publish a draft immediately.

Which platforms does the API support?

The REST API supports publishing and scheduling to X (Twitter), LinkedIn, and Pinterest. Each post targets one connected account. Pinterest posts require an image, a title, and a public Board. Instagram and TikTok scheduling are not currently available.

Can I schedule posts from ChatGPT or Claude?

Yes. Connect PostPiper’s hosted MCP server at https://mcp.postpiper.ai/mcp using OAuth in a compatible AI client. The assistant can create drafts and request your confirmation before publishing or scheduling. ChatGPT requires an account or workspace that supports custom MCP servers. See the MCP setup guide for client-specific instructions.

How much does the scheduling API cost?

New accounts receive 30 one-time free post credits, including API and MCP access. Pro starts at $10 per month for 1,000 successful posts, or $25 per month for 3,000. Both Pro tiers include unlimited connected accounts. Only successfully published posts count toward the allowance.

How do authentication and scheduling times work?

Authenticate REST requests with your API key in the Authorization: Bearer header. Connect a social account in the dashboard first. The scheduling endpoint accepts scheduled_at as a future ISO 8601 timestamp with Z for UTC or an explicit time zone offset. Responses normalize the scheduled time to UTC.

Can I review a post before it is published?

Yes. POST /posts creates an unpublished draft. Review or edit it before calling the publish or schedule endpoint. MCP publishing and scheduling require confirmation. You can track draft, scheduled, published, and failed posts through the API and review your posts in the dashboard.

Explore the REST API reference or follow the MCP setup guide.

Start scheduling in minutes.

Create a free account, grab an API key, and schedule your first post.

Start for free