> For the complete documentation index, see [llms.txt](https://help.contouron.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.contouron.com/platforms/youtube/faqs.md).

# FAQs

> For the complete documentation index, see [llms.txt](https://help.contouron.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.contouron.com/platforms/youtube/faqs.md).

## FAQs

### Can Contouron Write Description and Timestamps for Youtube?

Yes, first upload your Youtube video as public or unlisted. It takes \~20 mins before Contouron can access it publicly. Then, add the Youtube URL as a Source and use the prompt "Youtube Description & Timestamps". This will analyze your Youtube video and generate a description and clickable timestamps.

***

### Why does adding my YouTube video as a Source fail or say "error fetching"?

Adding a YouTube URL as a Source extracts the video transcript. Transcript extraction only reads **English**. If your YouTube video is in another language, or has no captions (subtitles), the extraction fails with an "error fetching" message.

Fixes:

1. Use a YouTube video that has **English captions**.
2. For a non-English video, open the video, copy the transcript or a summary, and add it as **Text** context instead.
3. Make sure the video is **public or unlisted**, and wait about 20 minutes after upload before Contouron can access it.

This English-only limit applies to YouTube and TikTok Source extraction. See Understanding Context for all supported context types.

***

### How Do You Upload Long Youtube Videos vs Youtube Shorts?

Youtube automatically identifies Shorts - if your video is less than 3 minutes long and vertical (9:16 aspect ratio), it will automatically be posted as a Youtube Short.

***

### How Do You Add Tags to Youtube Videos?

Botato currently doesn't support adding Tags to Youtube videos because Youtube's recommendation: *"Tags can be useful if the content of your video is commonly misspelled. Otherwise, tags play a minimal role in your video's discovery."* (Source: <https://support.google.com/youtube/answer/146402?hl=en>)

***

### "You have reached the maximum number of 10 posts for the last 24 hours for this account"

This error comes from YouTube, not Contouron. YouTube enforces a limit of 10 video uploads per channel per 24 hours via API.

To resolve this:

1. Wait for the 24-hour window to reset, then try again
2. Upload directly via the YouTube website in the meantime (this bypasses the API limit)
3. Space out your uploads throughout the day to avoid hitting the limit

This limit applies to all third-party apps that use the YouTube API, not only Contouron.

***

### Youtube API quota error "**The user has exceeded the number of videos they may upload"?**

The YouTube API error, **"The user has exceeded the number of videos they may upload,"** means that your YouTube account has hit one of YouTube's upload limits or quotas.

This could be due to:

1. **Daily Upload Limit** – YouTube enforces a cap on the number of videos an account can upload per 24 hours.
2. **Weekly or Periodic Limits** – Some accounts may have stricter limits depending on factors like age, activity, and compliance with YouTube's policies.
3. **Quota Limits on the API** – If you're uploading via the YouTube Data API, you may have hit your **quota limit** for video uploads.
4. **Account Restrictions** – New or unverified accounts may have lower upload limits.
5. **Violation of YouTube Policies** – If your account has received strikes or violations, YouTube may impose restrictions.

Solutions:

* **Wait and try again later** – If you've hit the daily limit, you might just need to wait 24 hours.
* **Check API quota usage** – If using the API, review your quota usage in the Google Cloud Console.
* **Verify your account** – Make sure your YouTube account is verified to increase your upload limits.
* **Check YouTube's official upload limits** – YouTube's limits can change, so check their official page.

***

### Youtube "Unauthorized" error?

To fix the Unauthorized error when posting to YouTube, try these steps:

1. Open an incognito Chrome browser
2. Log into your YouTube account
3. Log into Contouron
4. Reconnect your YouTube account to Contouron
5. If you are using a workflow automation, make sure you update your youtube account ID!

***

### How do you upload a video to Youtube?

**For YouTube Shorts:**

* Connect your YouTube account in Settings
* Go to the AI Agent and click "Add Post", then select YouTube
* Upload a video with 9:16 aspect ratio and under 3 minutes - it will automatically post as a YouTube Short

**For regular videos:**

* Go to the AI Agent
* Create a draft post
* Click "+ Add Media", then select "Upload File" to add your video

**If you're making videos in Contouron:**

* Click "Export Video" to create the final MP4
* Click "Create Post" to make a new post, then "Clone" to copy it to YouTube and other platforms
* YouTube automatically identifies Shorts based on length (under 3 minutes) and aspect ratio (9:16 vertical)

**If you're using a workflow automation tool:**

* Add a new node/module, search for Contouron, select platform "Youtube", and pass your publicly accessible video URL to be uploaded to Youtube

***

### Connected YouTube account but different channel not appearing?

Follow this troubleshooting guide for connecting your YouTube channels: <https://help.contouron.com/platforms/youtube/connect-accounts>

***

### How do I set the title and description when publishing to YouTube?

When publishing to YouTube from Contouron:

1. The post text becomes the YouTube video description
2. The title field becomes the YouTube video title

In the web app (AI Agent), the text you write in the post body becomes the YouTube description. The title field appears when you select YouTube as a platform.

When using the API, set `content.text` for the description and `target.title` for the video title.

Tags are not supported. YouTube recommends against relying on tags for discovery ([source](https://support.google.com/youtube/answer/146402?hl=en)).

***

### I get "target.title: must NOT have fewer than 1 characters" when scheduling

This error means the YouTube Title field is empty. YouTube requires a title, so a blank title blocks the post even when the main post box has text.

#### Using Contouron Web App

1. Open the post and confirm YouTube is selected as a platform
2. Scroll down on the right side of the composer to the YouTube options
3. Type a title in the Title field, so it has at least one character
4. Schedule or publish the post

#### Using Contouron API (n8n / Make.com)

1. Set `target.title` to a non-empty string for the YouTube post
2. Do not send an empty value or a variable that maps to blank

***

### How can I select the thumbnail of my YouTube video?

You can add a custom thumbnail when publishing to YouTube.

#### Using Contouron Web App

1. Create a post and select your YouTube account
2. In the scheduling screen, upload or select your custom thumbnail
3. Publish or schedule your post

#### Using Contouron API (n8n / Make.com)

1. Pass a `thumbnailUrl` field in the `target` object with a publicly accessible image URL
2. Publish or schedule your post

See: Publish Post API Reference

Custom thumbnails require a verified YouTube account with custom thumbnail capabilities enabled on YouTube.

***

### Why doesn't my custom YouTube thumbnail work?

If you connected your YouTube account before custom thumbnail support was added, or you verified your account after your first connected your YouTube account to Contouron, you'll need to re-connect your account.

To re-connect:

1. Go to Settings
2. Click "Login with YouTube" or click the "Reconnect" button on your YouTube account
3. Grant all requested permissions

YouTube requires that your account is verified and in good standing before you can use custom thumbnails on your videos If your account is not verified, see [YouTube's verification guide](https://support.google.com/youtube/answer/171664).

***

### How do I add a YouTube video to a playlist?

When publishing to YouTube, you can add your video to an existing playlist.

1. Select your YouTube account to publish to
2. A playlist dropdown appears after selecting the account
3. Choose the playlist you want to add your video to
4. Publish or schedule your post

This works in both the AI Agent and the post creation screen.

***

### Why don't I see my YouTube playlists?

If you connected your YouTube account before playlist support was added, you need to re-connect your account.

1. Go to Settings
2. Click "Login with YouTube" or click the "Reconnect" button on your account
3. Grant all requested permissions (playlists require additional permissions)

Your playlists will appear after re-connecting. Do not disconnect your account -- use the reconnect flow above.

***

**Didn't find your answer?**

* General FAQs
* [API FAQs](https://github.com/Contouron-Inc/help.contouron.com/blob/main/api/faqs.md)
* Video FAQs


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.contouron.com/platforms/youtube/faqs.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
