Skip to content

YouTube Scheduling API

Upload now and let YouTube publish later, or queue the upload itself. Each under its own key.

  • Schedule video 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: "Full walkthrough of the v2 dashboard, chapters in the description.",
  media: [
    {
      type: "video",
      url: "https://cdn.example.com/walkthrough.mp4"
    }
  ],
  youtube: {
    title: "Postkey v2 dashboard walkthrough",
    privacy: "public",
    madeForKids: false
  },
  scheduledFor: "2026-12-01T09:00:00Z"
});
  • YouTubequeued

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

Schedule your first YouTube post

  1. 1

    Connect YouTube

    Your customer signs in through YouTube'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 at that time, and a webhook tells you how it went.

Every YouTube 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 sit under "youtube".

A regular upload with title, description and privacy.

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": "Full walkthrough of the v2 dashboard, chapters in the description.",10  "media": [11    {12      "type": "video",13      "url": "https://cdn.example.com/walkthrough.mp4"14    }15  ],16  "youtube": {17    "title": "Postkey v2 dashboard walkthrough",18    "privacy": "public",19    "madeForKids": false20  },21  "scheduledFor": "2026-12-01T09:00:00Z"22}
Response

202 · scheduled

Queued under customer_42. It goes to YouTube 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"
    }
  ]
}

Everything you need for YouTube scheduling

  • Checked against YouTube's rules

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

    Title
    Up to 100 characterssource
    Description
    Up to 5,000 bytessource
    Unverified API projects
    Uploads are locked to private until auditedsource
  • One extra field

    Every YouTube 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's rules when you schedule, so problems show up now.

  • Resumable uploads

    Big files go up in chunks and pick up where they stopped if the connection drops. You just send a URL or a file.

  • Privacy and audience

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

Also for YouTube

PostingYouTube Posting APIUpload videos to YouTube with title, description and privacy set, without writing the upload flow yourself.See the page

Keys & control

Every YouTube post has an owner

Each customer or agent posts to YouTube 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 scheduling questions

Something not here? Email hello@postkey.dev.

What can I upload to YouTube?

Regular videos with title, description, privacy and the made-for-kids setting. For vertical short clips, see the YouTube Shorts page.

Why does the response say 'processing'?

YouTube processes every upload before it's watchable. The call returns right away and a webhook follows when it's done.

Why would an upload end up private?

YouTube locks uploads from API projects that haven't passed its audit to private. It's a YouTube rule for all API apps.

Can I set the publish time on YouTube itself?

Yes. Use the scheduling API and the video is uploaded as private with a publish time, so YouTube makes it public on time.

Do large files work?

Yes. Uploads are resumable, so a dropped connection doesn't mean starting over.

How do I schedule a YouTube 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 with a key per customer.

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