YOUTUBE

YouTube Upload API: Publish & Schedule Videos and Shorts

Publish and schedule YouTube videos (Shorts included), with one API key. No Google OAuth verification, no quota math and no resumable uploads.

Free plan · 2 accounts · No credit card · API + MCP included

SEND FROMYour appAI agentn8n / ZapierPOST /v1/posts · YOUTUBE · SHORT← publishedWoopSocialAlready verifiedValidateChannelUpload videoShortScheduleFri 17:00Publishtoken refreshedyour_brandYouTubeSHORT000webhook
  • Videos
  • Shorts
  • Public / Unlisted / Private
  • Categories & tags
  • Made-for-kids declaration
  • Scheduled publishing

Reviewed by Attila Kun, Technical Co-founder. Last updated 28 October 2026.

What is the YouTube Upload API?

The official YouTube Upload API is the way apps publish videos to the YouTube platform using the YouTube Data API's videos.insert endpoint. It requires a resumable upload through several steps, uses Google OAuth verification for the youtube.upload. scope (it can take about 4 to 6 weeks to get access to this), and it runs on the daily quota of 10,000 units per Google project. However, the publishAt endpoint does not schedule Shorts.

WoopSocial helps you use the YouTube upload API without Google's verification process, quota math or resumable upload. This is because WoopSocial is already verified, and does everything for you. This means you connect a channel once and start uploading - plus it's free for up to 2 accounts.

WoopSocial vs the YouTube Data API

Comparison of the YouTube Data API direct versus WoopSocial for uploading
YouTube Data API directWoopSocial
Google OAuth verification for youtube.upload, often 4 to 6 weeksAlready verified
10,000 quota units a day per projectNo quota math on your side
A resumable, three-step uploadUpload sessions up to 5 GB, then one post call
publishAt can’t schedule ShortsSchedule Shorts like any other video
No service accounts: separate OAuth and refresh tokens for each channelConnect each channel once, with tokens handled for you

Three steps to automated YouTube uploads

  1. Step 1

    Connect your channel

    Share a hosted connect link with yourself or your own users and they simply approve access in a few clicks. YouTube doesn't support service accounts, so each individual channel must individually authorize. WoopSocial stores and refreshes the tokens for each one.

  2. Step 2

    Create the post

    Send one request describing the upload: the YouTube channel, a title, a privacy setting (public, private or unlisted), the made-for-kids declaration, optional category and tags, your video, and when it should be published. Use SCHEDULE_FOR_LATER with a UTC timestamp to queue it. Or save a draft.

  3. Step 3

    We handle the rest

    WoopSocial opens the upload session, runs YouTube's resumable upload, manages the quota, then publishes at the scheduled time. If there is a temporary failure, it will retry - you will be notified via webhooks if a video is published or if it fails.

Everything you need to ship YouTube features

Videos & Shorts

Upload a standard video or a Short via the same endpoint. YouTube determines whether a video is a Short based on the file - vertical or square, and within the Shorts length limit.

Shorts scheduling

YouTube’s own publishAt doesn’t work for Shorts. WoopSocial’s scheduling does, so you can queue a Short for a specific time.

Complete metadata

Set the details like title, privacy, category, tags and made-for-kids declaration on every upload. This ensures videos publish successfully and stay on without any errors.

Big files

Upload sessions handle files up to 5 GB, meaning you don't have to do your own chunking of large videos.

Multiple channels behind one key

YouTube needs separate OAuth verification for every channel. WoopSocial connects each one just once and one API key to publish on all.

Cross-post Shorts to Reels and TikTok

Send the same vertical clip to Instagram Reels and TikTok in the same request, with a different caption for each using contentOverride.

Three ways in

REST. MCP. Example prompt: “Upload this clip as an unlisted Short titled ‘…’, make it public Friday 5pm”. Agent pages: /hermes/youtube, /muse/youtube, /grok/youtube. n8n, Zapier, Make.

  1. 1 · Account

    Create a free WoopSocial account

    Sign up at app.woopsocial.com/signup (no credit card). You'll authorize through OAuth when the agent connects — no API key required for MCP.

  2. 2 · YouTube

    Connect your channel

    Link a YouTube channel in the WoopSocial dashboard before you ask an agent to upload. Each channel authorizes on its own.

  3. 3 · Agent

    Add the MCP URL and authorize

    Use https://api.woopsocial.com/mcp. Your client opens OAuth — approve access and you're connected. Docs: Integrating MCP clients.

Install by client

Pick your agent. Cards marked On this site open another WoopSocial page; External opens outside this site (new tab).

Config for Cursor / other MCP clients

Prefer 1-click? Install the WoopSocial Cursor plugin. Or paste this into .cursor/mcp.json (or your client's MCP config). Authorize with OAuth when prompted — no API key in the URL. Allowlist *.cloudflarestorage.com if media uploads are blocked.

json
{
  "mcpServers": {
    "woopsocial": {
      "url": "https://api.woopsocial.com/mcp"
    }
  }
}

Claude Code

One command registers the remote HTTP MCP server. Complete OAuth when prompted.

bash
claude mcp add --transport http woopsocial "https://api.woopsocial.com/mcp"

After install — try this

Plain-language YouTube prompt

You

Upload this clip as an unlisted Short titled '…', make it public Friday 5pm

Prefer a full walkthrough with screenshots? Start at /social-media-mcp.

REST API example: schedule a YouTube Short

Same POST /posts call with a Bearer API key. Authorization header and request body included.

bash
curl -X POST https://api.woopsocial.com/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": [{
      "text": "New this week.",
      "media": [{ "type": "MEDIA_LIBRARY", "mediaId": "MEDIA_ID" }]
    }],
    "schedule": {
      "type": "SCHEDULE_FOR_LATER",
      "scheduledFor": "2026-07-03T17:00:00Z"
    },
    "socialAccounts": [{
      "platform": "YOUTUBE",
      "socialAccountId": "YOUR_YT_CHANNEL_ID",
      "title": "New this week",
      "privacy": "unlisted",
      "madeForKids": false
    }]
  }'

Prefer a calendar? Schedule YouTube videos from the dashboard

You can schedule YouTube videos and Shorts on the WoopSocial dashboard by simply selecting a date and time for each one. Link multiple channels and manage them side by side - perfect for agencies and creators who manage more than one channel. AI captions will get you past the blank page, and cross-posting will send a Short to Instagram and TikTok from the same screen. The dashboard is built on the same backend as the API, so a video scheduled by your team in the calendar will behave just like one created by your code. The free plan includes 2 accounts, no credit card required.

Schedule from the dashboard
WoopSocial calendar for scheduling YouTube videos

YouTube requirements & limits

  • Shorts

    A YouTube Short is a vertical or square video that is up to 180 seconds/3 minutes, as stated by YouTube as of October 2024.

  • Text limits

    Titles can be up to 100 characters. Descriptions can be up to 5,000 bytes, and tags up to 500 characters in total.

  • Made for kids

    You must declare made-for-kids on every upload, because of YouTube/COPPA rules. WoopSocial treats the field as required, so no video goes out without it.

  • Longer videos

    Videos over 15 minutes need a verified YouTube account. YouTube publishes no fixed daily upload number.

Cross-post a Short

Short to TikTok + Instagram Reels + Facebook Reels.

FAQ

Can I schedule YouTube Shorts via API?

Yes. YouTube's publishAt parameter doesn't support Shorts, but WoopSocial's scheduling does. Set SCHEDULE_FOR_LATER with a UTC timestamp and upload a vertical or square video within Shorts length limit, and WoopSocial will publish it at the specified time.

Do I need to verify a Google Cloud app?

No. WoopSocial is already verified for the youtube.upload scope, so you just connect your channel and start uploading. You skip the brand verification process, demo video and the 4 to 6 weeks of review. You also don't have to set up a Google Cloud project of your own.

How does the YouTube quota affect me?

YouTube officially provides every project with 10,000 quota units that can be used per day (24 hours). An upload costs about 100 units since December 2025. YouTube now also has a separate endpoint for video uploads; the limit for this endpoint is officially 100.

Can I upload unlisted or private videos?

Yes. Make sure the privacy setting on each upload is set to public, private or unlisted. Unlisted is perfect for when you want a link to share privately, while private keeps the video visible only to you.

Can I set tags, category and made-for-kids?

Yes. Feel free to add tags and a category if you like, and declare made-for-kids on every upload, because YouTube's COPPA rules require it.

How large can uploads be?

Up to 5 GB through upload sessions. You send the file in a session, then make one post call, and WoopSocial runs YouTube's resumable upload for you - no need to use chunking code for large videos. Videos over 15 minutes also need a verified YouTube account.

Can I manage multiple channels?

Yes. YouTube requires its own OAuth consent for each channel, and service accounts don't work. WoopSocial needs to connect each channel only once, and then you can publish to any of them with any API key.

Does it include YouTube analytics?

Yes. WoopSocial returns YouTube analytics, so you can use WoopSocial for views and watch time. You can also use WoopSocial to get YouTube analytics for your channel.

Can AI agents upload to YouTube?

Yes. WoopSocial's MCP server works in Claude, ChatGPT and Cursor, so you can ask your agent to upload/schedule a video in plain language. Your AI client asks for approval before anything is published, so there's nothing to worry about. Our guide to scheduling social media posts with MCP covers the entire setup.

Is it possible to set a custom thumbnail via the API?

Yes. Thumbnails are supported in WoopSocial and can be used in your API as well.

Can I add a video to a playlist through the API?

No. Playlists are not supported, but you can set the privacy level, category and add tags through the API.

Can I use the API to schedule a YouTube Premiere?

No. Premieres are not supported with the posting API. You need to do this directly from YouTube Studio.

Is it possible to edit or cancel a scheduled upload?

Yes, you can. A scheduled upload can always be edited or cancelled as long as it has not been posted yet. You can also save your post as a draft to ensure that you can double check everything before the post goes out.

What happens when my channel's token expires?

WoopSocial takes care of the token expiry for you by automatically refreshing tokens. This means you do not have to worry about setting this up yourself, this is all done for you.

Post to more than YouTube

Same API key. Same request format. Same across all the networks listed below. One integration for all of these networks.

Start posting to YouTube today

“The success rate of posts being published across social media platforms has also been very good. So far, I have shared around 500-600 pieces of content, and I have only had errors in a very small number of them. Most of those were caused by YouTube limits, so overall I would say the experience has been quite stable. In general, I'm happy with WoopSocial, and the main reasons I keep using it are the fair pricing, wide range of supported social media platforms, and how quickly you respond to user needs.”

Mazlum

Connect a YouTube channel, grab a free API key and upload your first video in minutes. No Google verification, no quota math, no credit card.

Free plan · 2 accounts · No credit card · API + MCP included