Skip to content

YouTube Shorts Posting API

Publish vertical short videos to YouTube Shorts, or send the same clip to Shorts, Reels and TikTok in one call.

  • Shorts from the same endpoint as every other post
  • Length and shape checked before upload
  • Channels connect through Google's login
  • Cross-post one clip to Reels and TikTok too
post.tsnode
const pk = new Postkey(process.env.POSTKEY_KEY);

await pk.posts.create({
  accounts: [
    "acc_yt_654"
  ],
  content: "The 20-second version of our launch #Shorts",
  media: [
    {
      type: "video",
      url: "https://cdn.example.com/launch-vertical.mp4"
    }
  ],
  youtube: {
    format: "short",
    title: "Launch in 20 seconds",
    privacy: "public",
    madeForKids: false
  }
});
  • YouTube Shortsprocessing

YouTube Shorts is processing it · webhook on finish

Your first YouTube Shorts post in three steps

  1. 1

    Connect YouTube Shorts

    Your customer signs in through YouTube Shorts's own login. You get an account ID, never a password.

  2. 2

    Make a key

    Create a key for that customer or agent, scoped to their accounts, with the caps you choose.

  3. 3

    Post

    Send the post to /v1/posts with that key. The YouTube Shorts result comes back in the response and by webhook.

Every YouTube Shorts format, one endpoint

Pick a format to see the exact request and what comes back. Options that only make sense on YouTube Shorts sit under "youtube".

A vertical or square clip that YouTube shows as a Short.

RequestREST
1POST https://api.postkey.dev/v1/posts2Authorization: Bearer pk_cust_42_…3Content-Type: application/json4 5{6  "accounts": [7    "acc_yt_654"8  ],9  "content": "The 20-second version of our launch #Shorts",10  "media": [11    {12      "type": "video",13      "url": "https://cdn.example.com/launch-vertical.mp4"14    }15  ],16  "youtube": {17    "format": "short",18    "title": "Launch in 20 seconds",19    "privacy": "public",20    "madeForKids": false21  }22}
Response

202 · processing

YouTube Shorts processes this first. The final result arrives by webhook.

{
  "id": "post_3k9d2",
  "status": "processing",
  "results": [
    {
      "account": "acc_yt_654",
      "platform": "youtube",
      "status": "processing",
      "format": "short"
    }
  ]
}

Everything you need for YouTube Shorts posting

  • Checked against YouTube Shorts's rules

    Before anything is sent, Postkey checks it against YouTube Shorts's published limits:

    Length
    Up to 3 minutessource
    Shape
    Vertical or square videosource
    Title
    Up to 100 characterssource
  • Same upload, Short result

    YouTube has no separate Shorts API. A short vertical or square video uploaded normally becomes a Short. Postkey checks it qualifies first.

  • One clip, three platforms

    Add Instagram and TikTok account IDs to the same request and the clip goes out as a Short, a Reel and a TikTok.

  • Processing tracked

    YouTube processes the upload first. A webhook tells you when the Short is live, or why it failed.

  • Privacy and audience

    Set public, unlisted or private and the made-for-kids flag in the same call.

  • Caps per key

    Uploads use YouTube API quota. Per-key caps stop one customer or agent from using all of it.

Also for YouTube Shorts

SchedulingYouTube Shorts Scheduling APIQueue Shorts for later, or let YouTube publish them at a set time. Each under its own key.See the page

Keys & control

Every YouTube Shorts post has an owner

Each customer or agent posts to YouTube Shorts through its own key: only its accounts, its own caps, its own log, and an off switch that touches nothing else.

Works with your stack

  • Your code

    Node and Python SDKs with the same calls, or plain REST from anything that speaks HTTP.

    • Node
    • Python
    • {}REST
    Read the docs
  • No-code tools

    Call the REST API from an HTTP step in n8n, Make or Zapier. Give each workflow its own key.

    • n8n
    • Make
    • Zapier
    Postkey with n8n
  • AI agents & MCP

    The MCP server lets Claude, Cursor and other agent tools post through their own key, with caps they can't change.

    • MCP server
    About the MCP server

YouTube Shorts posting questions

Something not here? Email hello@postkey.dev.

Is there a separate YouTube Shorts API?

No. Shorts are uploaded through the normal YouTube upload. A short vertical or square video becomes a Short. Postkey checks length and shape before sending.

What makes a video count as a Short?

YouTube's own rules: a vertical or square video within the length limit listed above.

Can I post the same clip to Reels and TikTok?

Yes. Put the Instagram and TikTok account IDs in the same request. Each platform gets its own result and webhook.

Why does the response say 'processing'?

YouTube processes the upload before the Short is live. A webhook follows with the final result.

Why would a Short end up private?

YouTube locks uploads from API projects that haven't passed its audit to private, for every API app.

Can I schedule YouTube Shorts posts instead?

Yes. Add scheduledFor to the same request. See the YouTube Shorts Scheduling API page for details.

Post to YouTube Shorts with a key per customer.

Get a key, connect an account, send the request above.