Skip to content
pozy
Start free

POST/v1/posts· 28 operations

One request publishes to every platform you connect.

Send text, images, video, carousels and threads to 13 platforms with a single body. Platform options sit inside the same request, so you maintain one integration instead of one per platform.

Start freeRead the docs
api.pozy.aiExample
POST/v1/posts201 Created
{ "content": "We just shipped dark mode.",
  "platforms": [ 6 accounts ] }

  • Instagram

    @acme

    Published

  • TikTok

    @acme.app

    Published

  • YouTube

    Acme

    Published

  • LinkedIn

    Acme Inc.

    Tue 09:00

  • Threads

    @acme

    Published

  • Bluesky

    acme.bsky.social

    Published
post.publishedwebhook

X-Pozy-Signature: 9f2c41e0b7…

What you can do

Social media API, in detail.

One shape for every platform
content, mediaItems and a platforms array with an accountId each. Override the caption or media for any one platform with customContent and customMedia.
Native options where they matter
TikTok privacy and duet settings, YouTube title and visibility, Pinterest board and link, Instagram reels, stories and collaborators, first comments on Facebook, LinkedIn and Threads, threads on X and Bluesky.
Schedule in any time zone
Publish now, set scheduledFor with an IANA time zone, save a draft, or ask for approval before anything goes out.
Media that fits
Upload large video files straight to storage with a presigned URL, then let Pozy prepare the file for each platform before it posts.
Safe to retry
Send an Idempotency-Key and a repeated request returns the first result. If one platform fails, retry that platform alone.
Events for every state
post.scheduled, post.published, post.failed and per-platform events arrive by webhook, signed with X-Pozy-Signature.

The API

One request away.

Every Pozy feature is an API call first. The dashboard and the MCP server use the same endpoints you do.

Works with

Full reference in the docs
POST /v1/posts
curl https://api.pozy.ai/v1/posts \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Idempotency-Key: launch-week-01" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "We just shipped dark mode.",
    "mediaItems": [{ "type": "video", "url": "https://cdn.example.com/dark-mode.mp4" }],
    "platforms": [
      { "platform": "tiktok", "accountId": "acc_tt_01" },
      { "platform": "instagram", "accountId": "acc_ig_01",
        "platformSpecificData": { "shareToFeed": true } },
      { "platform": "youtube", "accountId": "acc_yt_01",
        "platformSpecificData": { "title": "Dark mode is here", "visibility": "public" } }
    ],
    "scheduledFor": "2026-11-03T09:00:00",
    "timezone": "Europe/Madrid"
  }'

Questions

Good to know.

Do I need my own developer apps on each platform?
No. Accounts connect through each platform's own consent screen and you can start posting straight away. Using your own platform apps, so the consent screen shows your app's name, is coming soon.
What happens if one platform rejects a post?
The other platforms still publish. The post is marked partial, the failed platform gets a plain error category such as auth_expired or platform_rejected, and you can retry just that platform.
What do I pay for social media API?
Every Pozy account includes it. You pay per connected account: the first 2 are free, then $6 each for accounts 3 to 10, $3 each for 11 to 100 and $1 each from 101, per month. On top of that: X API calls are billed per call: $0.015 per post and $0.20 for a post with a link, $0.005 per read. Every rate is on the pricing page.
Can my AI agent use this?
Yes. Everything here is available through the Pozy MCP server at https://mcp.pozy.ai/mcp, with the permissions you approve when you sign in.

Often used with

Scheduler

Queues, time zones, drafts and approvals.

GET /v1/queue/next-slot· 21 ops

Bulk scheduling

A CSV in, hundreds of scheduled posts out.

POST /v1/posts/bulk-upload· 5 ops

Analytics

One set of metrics for every account.

GET /v1/analytics· 41 ops

White-label

Your brand on the connect screen.

PUT /v1/connect/welcome-screen· 61 ops

Connect your first 2 accounts free.

No trial clock, every feature on, and no card unless you connect X. Add more accounts when you are ready.

Start freeTalk to us