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
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
Connect YouTube Shorts
Your customer signs in through YouTube Shorts's own login. You get an account ID, never a password.
- 2
Make a key
Create a key for that customer or agent, scoped to their accounts, with the caps you choose.
- 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.
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}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:
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
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
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
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
Beyond YouTube Shorts
Same request shape on every platform. Add an account ID and the post goes there too.
- X Scheduling APIText · Image · Video · Thread
- Instagram Scheduling APIFeed post · Reel · Story · Carousel
- Facebook Scheduling APIText · Photo · Video
- TikTok Scheduling APIVideo · Photo
- LinkedIn Scheduling APIText · Image · Document
- YouTube Scheduling APIVideo
- You're hereYouTube Shorts Scheduling APIShort
- Pinterest Scheduling APIPin
- Google Business Scheduling APIUpdate post · Offer · Event
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.
Free to start. Read the docs