Skip to content
Schedule Social Media

Press Esc to close.

YouTube posts API: what the pilot allows, and no scheduling

YouTube's Data API now has a posts resource for text and image posts, but only for pilot partners until 2027, and posts publish immediately. What tools can do.

YouTube's Data API gained a posts resource on November 16, 2026, so apps can publish text and image posts to a channel's Posts tab. For now only select launch partners can use it, with public access planned for 2027, and posts sent through the API go live immediately: the API can't schedule them.

What this means for you

If you've wanted your scheduler to post YouTube updates next to your other networks, it's coming, but not yet for most tools. Only apps in YouTube's pilot can use it, and the wider release is planned for 2027. When your tool does add it, scheduling will work the way it does for most networks: the tool keeps your post and sends it at the time you picked.

The details

What the posts API can do

MethodWhat it doesQuota cost
posts.insertCreates and publishes a text-only post, or an image post with 1 to 10 images and optional text1 unit (Post Uploads quota)
posts.imageUploadUploads one image and returns a token to attach to a new post1 unit (Post Modifications and Image Uploads quota)
posts.updateChanges a post's text only; images can't be added, removed or replaced1 unit (Post Modifications and Image Uploads quota)
posts.deleteDeletes a post1 unit (Post Modifications and Image Uploads quota)
posts.listLists a channel's posts (up to 50 per page) or posts by ID, with likes and comments counts1 unit (Post List Queries quota)

All of these quotas are separate from the default YouTube Data API quota, so posting doesn't eat into the units you spend on video uploads. For the video side, see YouTube Data API quota.

Who can use it

The docs are clear: the resource and its methods "are in a pilot phase with access limited to select launch partners (approved Google Cloud projects)." Broader public API access is planned for general availability in 2027. YouTube doesn't publish how to apply, and the posts resource isn't in the public discovery document yet. Approved projects can also use comments on posts.

Why there's no scheduling

posts.insert says: "Posts that you create with this method are public and are published immediately. Scheduled posts aren't supported." The resource does have a publishingStatus of scheduled, and channel owners can read scheduled and archived posts with posts.list, but the API can't create one. So a scheduler that supports YouTube posts has to store each post and call posts.insert when it's due, as tools already do for networks such as LinkedIn.

Images

  • Formats: JPEG, PNG, GIF or WebP; YouTube checks the format from the file itself.
  • Size: up to 16 MB per image.
  • Shape: aspect ratio between 2:5 and 5:2. YouTube may show a different crop, such as a square, depending on where the post appears.
  • Tokens: each upload token works only for the channel it was uploaded for. Upload again for each post rather than reusing a token.

Also in the November 16 update

  • Paid product placement: hasPaidProductPlacement no longer defaults to false on videos.insert and videos.update. Tools must now send it explicitly: see the entry.
  • Co-views: public view counts now include people watching together on a TV: see the entry.

The full change is in our changelog: YouTube Data API adds a posts resource. Everything YouTube is on the YouTube hub, and scheduling videos is covered in how to schedule YouTube videos.

What to do next

  • Business owners: Keep creating posts in YouTube Studio for now. Don't expect them in your scheduler before 2027 unless it says it's a launch partner.
  • Marketers and agencies: Ask your scheduler whether it plans YouTube posts support, and plan your YouTube post calendar by hand until then.
  • Developers: Build YouTube posts into your queue like any instant-publish network, upload images close to send time, and check your upload forms send hasPaidProductPlacement from now on.

Questions people ask

Is there a YouTube API for community posts?

Yes, since November 16, 2026, but only for select launch partners in a pilot. The YouTube Data API's new posts resource creates, lists, edits and deletes text and image posts. YouTube plans broader public access for general availability in 2027.

Can you schedule YouTube posts with the API?

No. YouTube's posts.insert documentation says posts created with the API are public and published immediately, and that scheduled posts aren't supported. A scheduler has to keep the post and send it at the chosen time.

How many images can a YouTube post have through the API?

1 to 10. Each image is uploaded first with posts.imageUpload (JPEG, PNG, GIF or WebP, up to 16 MB, aspect ratio between 2:5 and 5:2) and attached to the post with the returned token.

Sources

Related

Get an email when a platform changes its API

One email per new entry: what changed, who is affected, and the deadline.

Follow with RSS, or per platform, for example X or Meta. All feeds.