Skip to content

YouTube Shorts Scheduling API

Queue Shorts for later, or let YouTube publish them at a set time. Each under its own key.

  • Schedule short posts
  • Exact times in ISO 8601
  • Reschedule or cancel until it goes out
  • Same limits, log and webhooks as posting now
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
  },
  scheduledFor: "2026-12-01T09:00:00Z"
});
  • YouTube Shortsqueued

Queued for Dec 1, 09:00 UTC · key customer_42

Schedule your first YouTube Shorts post

  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

    Schedule

    Add scheduledFor to the same request. It goes to YouTube Shorts at that time, and a webhook tells you how it went.

Every YouTube Shorts format, one endpoint

Pick a format to see the exact request with a publish time 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  "scheduledFor": "2026-12-01T09:00:00Z"23}
Response

202 · scheduled

Queued under customer_42. It goes to YouTube Shorts at the time you set.

{
  "id": "post_3k9d2",
  "status": "scheduled",
  "scheduledFor": "2026-12-01T09:00:00Z",
  "results": [
    {
      "account": "acc_yt_654",
      "platform": "youtube",
      "status": "queued",
      "format": "short"
    }
  ]
}

Everything you need for YouTube Shorts scheduling

  • 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
  • One extra field

    Every YouTube Shorts format you can post now can be scheduled with scheduledFor. Nothing else changes.

  • Move or cancel

    Change the time or cancel the post with one call before it goes out.

  • Checked when queued

    Text and media are checked against YouTube Shorts's rules when you schedule, so problems show up now.

  • 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.

Also for YouTube Shorts

PostingYouTube Shorts Posting APIPublish vertical short videos to YouTube Shorts, or send the same clip to Shorts, Reels and TikTok in one call.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 scheduling 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.

How do I schedule a YouTube Shorts post?

Send the normal post request with scheduledFor in ISO 8601 (UTC or with an offset). You can cancel or move it until it goes out.

Schedule to YouTube Shorts with a key per customer.

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