Files
AutoGPT/docs/integrations/block-integrations/ayrshare/post_to_youtube.md
Nicholas Tindle 90466908a8 refactor(docs): restructure platform docs for GitBook and remove MkDo… (#11825)
<!-- Clearly explain the need for these changes: -->
we met some reality when merging into the docs site but this fixes it
### Changes 🏗️
updates paths, adds some guides
<!-- Concisely describe all of the changes made in this pull request:
-->
update to match reality
### Checklist 📋

#### For code changes:
- [x] I have clearly listed my changes in the PR description
- [x] I have made a test plan
- [x] I have tested my changes according to the test plan:
  <!-- Put your test plan here: -->
  - [x] deploy it and validate

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> Aligns block integrations documentation with GitBook.
> 
> - Changes generator default output to
`docs/integrations/block-integrations` and writes overview `README.md`
and `SUMMARY.md` at `docs/integrations/`
> - Adds GitBook frontmatter and hint syntax to overview; prefixes block
links with `block-integrations/`
> - Introduces `generate_summary_md` to build GitBook navigation
(including optional `guides/`)
> - Preserves per-block manual sections and adds optional `extras` +
file-level `additional_content`
> - Updates sync checker to validate parent `README.md` and `SUMMARY.md`
> - Rewrites `docs/integrations/README.md` with GitBook frontmatter and
updated links; adds `docs/integrations/SUMMARY.md`
> - Adds new guides: `guides/llm-providers.md`,
`guides/voice-providers.md`
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
fdb7ff8111. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
Co-authored-by: bobby.gaffin <bobby.gaffin@agpt.co>
2026-01-23 06:18:16 +00:00

3.8 KiB

Ayrshare Post To YouTube

Blocks for uploading videos to YouTube using the Ayrshare social media management API.

Post To You Tube

What it is

Post to YouTube using Ayrshare

How it works

This block uses Ayrshare's API to upload videos to YouTube. It handles video uploads with extensive metadata including titles, descriptions, tags, custom thumbnails, playlist assignment, category selection, and visibility controls (public, private, unlisted).

The block supports YouTube Shorts (up to 3 minutes), geographic targeting to allow or block specific countries, subtitle files (SRT/SBV format), synthetic/AI content disclosure, kids content labeling, and subscriber notification controls. Videos can be scheduled for specific publish times.

Inputs

Input Description Type Required
post Video description (max 5,000 chars, empty string allowed). Cannot contain < or > characters. str Yes
media_urls Required video URL. YouTube only supports 1 video per post. List[str] No
is_video Whether the media is a video bool No
schedule_date UTC datetime for scheduling (YYYY-MM-DDThh:mm:ssZ) str (date-time) No
disable_comments Whether to disable comments bool No
shorten_links Whether to shorten links bool No
unsplash Unsplash image configuration str No
requires_approval Whether to enable approval workflow bool No
random_post Whether to generate random post text bool No
random_media_url Whether to generate random media bool No
notes Additional notes for the post str No
title Video title (max 100 chars, required). Cannot contain < or > characters. str Yes
visibility Video visibility: 'private' (default), 'public' , or 'unlisted' "private" | "public" | "unlisted" No
thumbnail Thumbnail URL (JPEG/PNG under 2MB, must end in .png/.jpg/.jpeg). Requires phone verification. str No
playlist_id Playlist ID to add video (user must own playlist) str No
tags Video tags (min 2 chars each, max 500 chars total) List[str] No
made_for_kids Self-declared kids content bool No
is_shorts Post as YouTube Short (max 3 minutes, adds #shorts) bool No
notify_subscribers Send notification to subscribers bool No
category_id Video category ID (e.g., 24 = Entertainment) int No
contains_synthetic_media Disclose realistic AI/synthetic content bool No
publish_at UTC publish time (YouTube controlled, format: 2022-10-08T21:18:36Z) str No
targeting_block_countries Country codes to block from viewing (e.g., ['US', 'CA']) List[str] No
targeting_allow_countries Country codes to allow viewing (e.g., ['GB', 'AU']) List[str] No
subtitle_url URL to SRT or SBV subtitle file (must be HTTPS and end in .srt/.sbv, under 100MB) str No
subtitle_language Language code for subtitles (default: 'en') str No
subtitle_name Name of caption track (max 150 chars, default: 'English') str No

Outputs

Output Description Type
error Error message if the operation failed str
post_result The result of the post PostResponse
post The result of the post PostIds

Possible use case

Video Publishing Pipeline: Automate video uploads with thumbnails, descriptions, and playlist organization for content creators.

YouTube Shorts Automation: Publish short-form vertical videos to YouTube Shorts with proper metadata and hashtags.

Multi-Region Content: Upload videos with geographic restrictions for region-specific content licensing or compliance.