Social media API

A social media scheduling API for six networks

Postprism’s social media scheduling API lets your code create, schedule, update and delete posts for LinkedIn, X, TikTok, YouTube, Bluesky and Pinterest with one API key. Send a version per network, upload images and video, read analytics, and see every post on your Postprism calendar.

Start free trial Read the API docs

Juniper Roasters

Create Post

Menu

Dashboard

Calendar

Media Library

Approvals

Analytics

Platforms

Developer

AI Assistant

Calendar|View and manage your scheduled content

Month

Week

Day

Platforms

Today

October 2026

Sun

Mon

Tue

Wed

Thu

Fri

Sat

11

9:30 AM

12

12:15 PM

13

14

15

2:20 PM

16

9:30 AM

17

2:20 PM

18

9:30 AM

19

20

21

6:40 PM

22

23

24

9:30 AM

25

2:20 PM

26

27

28

12:15 PM

29

30

31

9:30 AM

Terminal

$ curl -X POST https://studio.postprism.app/api/v1/posts \

-H "Authorization: Bearer $POSTPRISM_API_KEY" \

-d '{

"base_content": "Our autumn menu lands this Friday.",

"platforms": ["linkedin", "twitter"],

"platform_content": {

"linkedin": { "content": "Our autumn menu lands this Friday…" },

"twitter": { "content": "Autumn menu drops Friday…" }

},

"scheduled_at": "2026-10-16T09:30:00Z"

}'

HTTP 201 Created

{ "data": { "id": "3f1c2a9e-…", "status": "scheduled",

"scheduled_at": "2026-10-16T09:30:00Z" }, "error": null }

Send one request
Get the post back
See it on the calendar

How to schedule social media posts with an API

Four steps from a new API key to a post that publishes on time. The quick start has the full requests.

01
Connect your networks
Connect LinkedIn, X, TikTok, YouTube, Bluesky and Pinterest on the Platforms page in Postprism. Those are the accounts your code can post to.
02
Create an API key
Open Developer in Postprism and choose Generate API key. Name it after the integration, copy it once, and send it as a Bearer token on every request.
03
Send a post
POST to /posts with the networks, a version for each in platform_content and a scheduled_at time. Leave the time out to save a draft for review.
04
Check the result
The post appears on your Postprism calendar and publishes on time. Read it back to see its status, or list posts by status to find anything that needs attention.

What the Postprism API does

Ten endpoints for posts, media, analytics, connected platforms and workspaces, with the same JSON envelope on every response.

Create, list, update and delete posts

Create drafts or scheduled posts, list them newest first with a status filter, read one, change its text, networks, media or time, or delete it.

Up to 100 posts per page

A version per network in one request

platform_content holds the text and hashtags for each network, so one request sends a short X post and a long LinkedIn post together.

Per-network settings

Set LinkedIn visibility, TikTok privacy, a YouTube title, privacy, playlist and thumbnail, or a Pinterest board and link, in the same request.

Upload images and video

Upload JPEG, PNG, GIF or WebP images and MP4 or MOV video once, then attach the returned link to as many posts as you like.

Images 10 MB, video 100 MB, 10 files per post

Read analytics

Get views, likes, comments and shares for each published post and network, filtered by post or by platform.

One key, every workspace

Pass a workspace ID to act on any workspace you belong to, so one integration can run every client’s calendar. Your role applies, and Viewers can read but not change posts.

API keys on Freelancer and Agency

How a post moves through the Postprism API

Two requests from your code. Postprism keeps the post on your calendar and publishes it to each network at its time.

Leave out scheduled_at and the post waits as a draft on your calendar until someone schedules it.

Postprism API facts and limits

Endpoints, plans, media sizes and request limits, as published in the API docs.

Endpoints: The figure10 REST endpointsPostprism API docs; How it works in PostprismPosts (list, create, get, update, delete), media upload, analytics, connected platforms, your workspace and every workspace you belong to.
Plans: The figureFreelancer and AgencyPricing; How it works in PostprismAPI keys come with Freelancer ($49 a month) and Agency ($99). The MCP server for AI assistants is on every plan.
Authentication: The figureAPI key as a Bearer tokenDocs: authentication; How it works in PostprismCreate and revoke keys on the Developer page. Make one key per integration so you can revoke one without breaking the others.
Networks: The figure6 platform keysDocs: platform guides; How it works in Postprismlinkedin, twitter, tiktok, youtube, bluesky and pinterest, plus LinkedIn Company Pages you connected.
Media: The figureImages 10 MB, video 100 MB, 10 files per postDocs: media requirements; How it works in PostprismJPEG, PNG, GIF and WebP images, MP4 and MOV video. Base64 uploads go up to 10 MB.
Scheduling: The figureAny future ISO 8601 timeDocs: drafts, scheduling and publishing; How it works in PostprismSend UTC or include an offset. Statuses are draft, scheduled, publishing, published and failed.
Request limits: The figure200 an hour per endpoint, 30 uploads an hourDocs: rate limits; How it works in PostprismCounted per user across your keys and workspaces. Back off and retry when a request is refused.
Pagination: The figureUp to 100 items per requestDocs: pagination; How it works in PostprismPage through posts with limit and offset; filter analytics by post or platform.

API quick start OpenAPI spec AI agents and MCP

Facts checked in Postprism on October 10, 2026

Who builds on the Postprism API

Teams that want posts to go out from their own systems, with a calendar people can still review.

Developers and product teams

Post release notes, launches and blog articles from your own app or CI job, with a version written for each network.

Automation builders

Turn an RSS item, a form entry or a spreadsheet row into a draft in an n8n workflow, and let a person schedule it.

Agencies

Run every client’s calendar from one integration by passing each client’s workspace, and keep client Viewers read-only.

Prefer an AI assistant? Use the MCP server

The Postprism MCP server gives Claude, ChatGPT, Cursor and other assistants the same posts, media and analytics as the API, without writing code.

AI agents and MCP MCP documentation

Same actions as the API

Each of the 11 MCP tools maps to an API endpoint, so limits and validation are the same.

Sign in, no key

Assistants sign in with your Postprism account, so the MCP server works on every plan, including the trial.

Guides for each assistant

Setup steps and prompts for Claude, Claude Code, ChatGPT, Cursor, Gemini CLI and n8n.

Drafts first

Ask for drafts and the assistant’s posts wait on your calendar until you schedule them.

You ask

List everything scheduled for next week across my client workspaces and move the Acme LinkedIn post to Thursday at 10 AM.

Postprism tools it uses

list_workspacesEvery workspace you belong to, so one agent can act for several brands.
list_postsList posts in a workspace, filtered by status (draft, scheduled, published).
update_postChange a post: copy, per-platform versions, media or the scheduled time.

Postprism API vs each network’s API vs other scheduler APIs

What you build and maintain when you post to several networks from code.

Networks per integration

Postprism

Six networks with one API key

Each network’s own API: One network per integration
Other scheduler APIs: Varies by tool

Getting access

Postprism

Generate a key on the Developer page

Each network’s own API: A developer app and credentials for each network, with access review on some
Other scheduler APIs: An API key, often on higher-priced plans

Per-network text

Postprism

A version per network in one request

Each network’s own API: One request per network, in each network’s format
Other scheduler APIs: Varies by tool

Media

Postprism

Upload once, attach to every network

Each network’s own API: Each network’s own upload flow
Other scheduler APIs: Varies by tool

Scheduling

Postprism

Send scheduled_at and Postprism publishes on time

Each network’s own API: Varies; often you run the timing yourself
Other scheduler APIs: Usually built in

Human review

Postprism

Every post on the Postprism calendar, drafts until scheduled

Each network’s own API: No shared calendar
Other scheduler APIs: Varies by tool

AI assistants

Postprism

MCP server with 11 tools on every plan

Each network’s own API: Build your own
Other scheduler APIs: Varies by tool

Cost

Postprism

Freelancer from $49 a month, with a 7-day free trial

Each network’s own API: Free to paid, depending on the network and volume
Other scheduler APIs: Varies by tool and plan

Sources:LinkedIn: Marketing API documentation · Meta for Developers: Instagram Platform · X Developer Platform

Build on Postprism with a 7-day free trial

Freelancer and Agency include API keys, and every plan includes the MCP server, the content calendar and unlimited posts.

Solo

$14

/mo

or $19/mo billed monthly

For freelancers managing one client brand.

Start free trial

1 workspace
All 6 platforms
150 AI adaptations per month
100 AI image generations per month
Publishing analytics
Email support

Social media API questions

Yes. The Postprism REST API creates, schedules, updates and deletes posts for LinkedIn, X, TikTok, YouTube, Bluesky and Pinterest, uploads images and video, and reads analytics. It uses an API key and returns JSON, and the full reference is in the Postprism developer docs.

API keys are included on Freelancer at $49 a month and Agency at $99 a month. Solo, at $19 a month, includes the MCP server for AI assistants but not API keys. Every plan starts with a 7-day free trial.

Each network has its own developer API, with its own app, credentials, access rules and pricing, and you build and maintain one integration per network. Postprism gives you one API for six networks with scheduling and a shared calendar, and you can try it free for 7 days.

Send a POST request to the posts endpoint with your API key, the networks in platforms, a version for each network in platform_content and an ISO 8601 scheduled_at time. The response returns the post with the status scheduled, and Postprism publishes it at that time. Without scheduled_at the post is saved as a draft.

LinkedIn profiles and Company Pages, X, TikTok, YouTube, Bluesky and Pinterest, using the accounts connected in your Postprism workspace. Each network has its own guide in the docs with its text limit, media rules and optional settings.

Yes. Upload JPEG, PNG, GIF or WebP images of up to 10 MB and MP4 or MOV video of up to 100 MB, then attach the returned link to a post. A post can carry up to 10 files, and you can reuse an uploaded file on as many posts as you like.

Yes. The analytics endpoint returns views, likes, comments and shares for each published post on each network, newest first, and you can filter it by post or by platform.

Yes. A key acts on its default workspace, and you can pass the ID of any other workspace you belong to, so one integration can run every client’s calendar. A workspace you do not belong to is refused rather than falling back to your default.

The REST API is for your own code and automation tools such as n8n and uses an API key on Freelancer and Agency. The MCP server is for AI assistants such as Claude, ChatGPT and Cursor, which sign in with your Postprism account on every plan. Both reach the same posts, media and analytics.

Yes. An OpenAPI 3.1 spec is published with the developer docs, so you can generate a client or import the endpoints into tools that read OpenAPI.

Keep learning about social media automation

Guides from our blog, the developer docs and the terms that come up when you post from code.

Related features and guides

Glossary

Developer docs

Ready to post to six networks from your code?

Start a trial on Freelancer, connect your accounts, create an API key and schedule your first post in three requests.

Start free trial