Platform guide

YouTube

Requires a Google account with an existing YouTube channel and permission to upload videos to it.

approval required5,000 UTF-8 bytes1 media item

Capabilities at a glance

AnalyticsSupportedCommentsNot availableMessagesNot availableRemote deletionSupportedToken refreshSupported

Connect YouTube

Create the hosted connection URL on your server. The customer completes OAuth or the provider-specific credential form directly on PostGate.

Connection requestPostGate API

curl -X POST https://postgate.studio/api/profiles/connect \
  -H "Authorization: Bearer $POSTGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "platform": "youtube",
  "profile_group_id": "grp_acme123",
  "return_url": "https://app.example.com/settings/social"
}'

Publish to YouTube

Use the connected profile ID as the target. Provider-specific fields live under post.options.youtube so the unified envelope remains stable.

Post envelopePostGate API

{
  "post": {
    "body": "Launch day.",
    "options": {
      "youtube": {
        "title": "Launch story",
        "privacy": "private",
        "made_for_kids": false,
        "community_guidelines_confirmed": true,
        "thumbnail_url": "https://example.com/thumbnail.jpg"
      }
    }
  },
  "profiles": [
    "pro_youtube123"
  ],
  "media": [
    "med_01JXYZ"
  ]
}

Media and content limits

PostGate validates the request at creation and again at delivery. Account-level provider limits can be narrower than the general contract.

Text5,000 UTF-8 bytes

LinksAllowed

Mediavideo · Up to 1

Image sizeProvider default

Video size256 GB

Video durationUp to 15 min

Operational notes

These constraints affect approval, connection health, or delivery behavior for this provider.

A YouTube Data API compliance audit is required for public and unlisted uploads.
Comment management is disabled for the current OAuth access tier.
Channels without phone verification (youtube.com/verify) are capped at 15-minute videos and a rolling daily upload limit that PostGate cannot check on the user’s behalf.
Custom thumbnail: set post.options.youtube.thumbnail_url to an https JPEG or PNG up to 2 MB (1280x720 recommended). It is applied right after the upload; the channel must be phone-verified. If YouTube refuses it, the video stays published and the target's provider response records thumbnail.status=failed with the reason.

Check live capability before showing the option

Call GET /api/platforms. A provider appears only when it is enabled and configured for the current workspace.

Next guideBuild the complete post envelope CompareAll platform capabilities