> ## Documentation Index
> Fetch the complete documentation index at: https://docs.postonce.to/llms.txt
> Use this file to discover all available pages before exploring further.

# Using YouTube with PostOnce

> Connect a YouTube channel to PostOnce, copy YouTube Shorts and videos to other platforms, and publish videos to YouTube as Shorts or regular videos. Shorts length, copyrighted music, videos over 15 minutes, limits and errors.

PostOnce can copy your YouTube Shorts and videos to other platforms, and upload videos from other platforms to YouTube.

## Connect YouTube

![The Connect YouTube dialog: the Google account must have a YouTube channel that supports Shorts](https://mintcdn.com/postonce-87a0d366/gMvPrsFcpML9jz9o/images/help/connect-youtube-dialog.webp?fit=max\&auto=format\&n=gMvPrsFcpML9jz9o\&q=85\&s=f459add57ff144986907257cc908393a)

1. On [Accounts](https://postonce.to/dashboard/accounts), click **Connect YouTube**, then **Connect**.
2. Choose the Google account that **owns the channel** and allow every permission Google asks for. If you untick a permission, uploads fail.

![Google's Choose an account list, blurred](https://mintcdn.com/postonce-87a0d366/eo2aVjXGLSoqYgJZ/images/help/youtube-connect-flow-1.webp?fit=max\&auto=format\&n=eo2aVjXGLSoqYgJZ\&q=85\&s=d2faa7b676b2330020690efe563a30b8)

![Google's screen where PostOnce asks for access to your Google Account, with Continue highlighted](https://mintcdn.com/postonce-87a0d366/eo2aVjXGLSoqYgJZ/images/help/youtube-connect-flow-2.webp?fit=max\&auto=format\&n=eo2aVjXGLSoqYgJZ\&q=85\&s=a086b855fb2df65e0f6a8fd9a983955b)

Google asks which account to use (1). Pick the one that owns your channel, then click Continue (2).

### Why PostOnce asks for these permissions

Google describes some of them in broad terms, like "manage your YouTube account". PostOnce only uses them to upload your videos and thumbnails, and to read your channel and videos so workflows can copy them and show your stats. It never deletes videos and never posts comments. If you untick a permission, uploads fail.

PostOnce connects the channel of the Google account you sign in with. If that account has no channel, create one at [youtube.com/create\_channel](https://www.youtube.com/create_channel) and connect again.

## YouTube as a source

* **Shorts** are copied by default. Turn on **Regular videos** in the workflow (or under **Settings › Source**) to copy longer, horizontal videos too.
* PostOnce checks YouTube for new videos every 25 minutes, or less often if the account hasn't posted for a few days ([schedule](https://docs.postonce.to/help/publishing-timing.md#how-often-postonce-checks-for-new-posts)).
* The copied caption is the video's title and description.
* Private, removed, sign-in-only and age-restricted videos can't be copied. If YouTube is still processing the video, PostOnce retries later.

## Publishing to YouTube

YouTube only accepts video. Images and text-only posts are skipped. Starting a new channel? See [Warm up a new account](https://docs.postonce.to/help/growth-guide/warm-up-accounts.md).

| | Limit |
| - | - |
| Title | 100 characters. Without a title, PostOnce uses the first line of the caption. |
| Description | 5,000 characters |
| Video | 1 video per post, up to 1 GB |
| Thumbnail | 2 MB |

**Shorts or regular video?** PostOnce uploads a video as a Short when it's vertical, or when it came from TikTok, an Instagram Reel or another YouTube Short. YouTube makes the final decision based on the video's length and shape.

YouTube treats vertical or square videos up to 3 minutes long as Shorts. Longer videos become regular videos, even if PostOnce sent them as Shorts.

Uploads are public by default and marked as not made for kids. In [Create Post](https://docs.postonce.to/help/create-and-schedule-posts.md) you can choose **Public**, **Unlisted** or **Private**. Up to 8 hashtags from the description are added as tags.

## Copyrighted music on YouTube

Music rights don't move with a video. A TikTok or Reel that uses licensed music can be claimed by YouTube's Content ID after upload. YouTube may then mute it, show ads for the music owner, or block it. YouTube blocks Shorts longer than 1 minute that have a Content ID claim.

To avoid this, use your own sound or music you're licensed to use on YouTube, or keep the Short under 1 minute. Videos whose sound TikTok already muted are copied without that sound ([Video quality and sound](https://docs.postonce.to/help/video-quality-and-sound.md)).

## Videos longer than 15 minutes

YouTube only accepts videos longer than 15 minutes from verified channels. Verify yours with a phone number at [youtube.com/verify](https://www.youtube.com/verify), then post again. PostOnce uploads up to 1 GB per video.

> [!NOTE]
>
> PostOnce marks a post as published once YouTube accepts the upload. If YouTube rejects or blocks the video afterwards, for length or a copyright claim, you see it in [YouTube Studio](https://studio.youtube.com) under **Content**, in the **Restrictions** column.

## What YouTube doesn't allow

* Only videos can be uploaded. Community posts and images aren't supported by YouTube's API.
* YouTube limits how many uploads an app can make each day. If the limit is reached, the upload fails with a quota message; retry the next day.

## YouTube errors

| Error message | What to do |
| - | - |
| "Permissions missing. Please try again and allow all access." | [Reconnect](https://docs.postonce.to/help/reconnect-an-account.md) YouTube and tick every permission. |
| "YouTube API quota exceeded. Please try again later." | Retry the next day. |
| "YouTube rejected the upload: {message}" | Fix what YouTube describes, often a channel restriction, then retry. |
| "Only video media is allowed for YouTube Shorts." / "Video is required to create a YouTube Short." | YouTube only accepts videos. |
| "Video too large for current YouTube upload path: {N}MB. Current limit is {M}MB." | Compress the video below 1 GB. |
| "YouTube suspended this channel. After resolving it with YouTube, please reconnect your account." | Resolve the suspension in YouTube Studio, then reconnect. |
| "No YouTube channel found" | Create a channel, or sign in with the Google account that owns it. |
| "This YouTube video is private or has been removed." | Make the source video public or unlisted. |
| "This YouTube video is age-restricted and can't be downloaded for cross-posting." | Upload the file with Create Post instead. |
| "YouTube only lets signed-in viewers watch this video, so it couldn't be downloaded." | Make the video available to everyone, or upload the file with Create Post. |
| "YouTube is still processing the source video; retry later." | Wait until YouTube finishes processing, then retry. |

## Still stuck?

Search this help center with <kbd>⌘</kbd> <kbd>K</kbd>, or email [support@postonce.to](mailto:support@postonce.to) from the address you use for PostOnce. Include the platform, the approximate time, and the exact message you saw. Never send passwords, access tokens, API keys, or card details.

Something missing from PostOnce? [Request a feature](https://postonce.featurebase.app/) or check the [roadmap](https://postonce.featurebase.app/roadmap).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.