Home / Docs / YouTube

YouTube Publishing Docs

Upload videos to connected YouTube channels with the Postifys API: title, privacy, thumbnails, and cURL examples.

Last updated: 2026-07-24 · Technical source: live Postifys API behavior and API reference

Quick answer: Video uploads to a connected YouTube channel. Use POST /api/youtube/post with Authorization: Bearer YOUR_API_KEY.

What Postifys supports

Video uploads to a connected YouTube channel.

Product overview: YouTube integration. Full field reference also lives on API docs.

Endpoint

POST /api/youtube/post · Auth: API key or session · Target field: channelId when needed

Permissions / scopes (as granted): youtube.upload (as granted via Google/YouTube connection)

Common fields

  • title - Required.
  • description - Optional.
  • channelId - Optional; must match a connected channel.
  • videoUrl - Required downloadable video URL.
  • thumbnailUrl - Optional public image URL.
  • privacyStatus - private (default), unlisted, or public.
  • tags / categoryId / notifySubscribers - Optional metadata fields.

cURL example

curl -X POST https://postifys.com/api/youtube/post \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "title": "Product walkthrough",
    "description": "Published via Postifys",
    "videoUrl": "https://example.com/walkthrough.mp4",
    "privacyStatus": "private"
  }'

Limitations

  • YouTube still processes the upload after Postifys submits it.
  • Format/length/policy rules are enforced by YouTube.
  • Requires youtube.upload capability on the connected Google account.

See also Media requirements, Errors, and Rate limits.