PostWing API

All-in-one social media posting API

One REST API to schedule Instagram, TikTok, LinkedIn, YouTube, X, Facebook, Pinterest, and Threads. Built for scripts, custom apps, and AI agents.

  • 7-day free trial
  • Full REST + OpenAPI
  • Plans from $9.99/mo

step by step

How to use the API

Create a key, then schedule a post.

01Create an API key

Open Dashboard → AI & API, create a key, and send it as Authorization: Bearer pw_live_…. Or connect with OAuth for third-party agents.

Endpoints

API base URL

https://postwing.io/api/v1

OpenAPI URL

https://postwing.io/api/v1/openapi.json
02Schedule a post

Call POST /posts/preview with a caption, time, and platforms. Full request and response details are in the API docs.

Example request
curl -s -X POST "https://postwing.io/api/v1/posts/preview" \
  -H "Authorization: Bearer pw_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "caption": "Hello from the PostWing API",
  "scheduled_at": "2026-10-05T09:00:00Z",
  "platforms": ["instagram", "linkedin"]
}'

what you can do

Everything the API covers

One REST surface for accounts, workspaces, media, and posts. Full field reference in the docs.

  • Schedule, edit, and cancel posts with preview → confirm
  • Connect, sync, and disconnect social accounts
  • List posts, fetch one post, and get schedule summaries
  • Upload images and videos with a direct upload URL, then schedule
  • Per-account captions and platform options (quote posts, boards, Reels, and more)

built-in safety

Nothing schedules until you confirm

The API never schedules in one shot. Preview returns a confirmation token bound to your user. Confirm only after you (or your operator) approve the draft.

  • Confirmed posts appear on your PostWing calendar right away
  • Cancel or edit later from the dashboard or with the same API
  • Scopes limit what each key or OAuth token can read or change

Platforms

Schedule to all 8 from the API

Same coverage as the dashboard. One key covers every network PostWing supports.

  • Instagram
  • TikTok
  • YouTube
  • LinkedIn
  • X
  • Facebook
  • Pinterest
  • Threads

prefer chat?

Prefer a different assistant?

questions

API FAQ

Yes. Posts you schedule through the API go into the same PostWing calendar and workspace as posts you create in the dashboard. You can edit or cancel them from the UI or the API.

ready when you are

Schedule your next post from the API

Create an API key, connect your accounts, and schedule with a preview you control.

7-day free trial · Cancel anytime