YouTube API

Postproxy uploads videos to a connected YouTube channel. The post body becomes the video description; the video file is required.

Every request below uses the base URL https://api.postproxy.dev and an Authorization: Bearer YOUR_API_KEY header. Replace YOUR_API_KEY and the example IDs with your own.

At a glance


Platform ID	`youtube`
Formats	`post` (channel video)
Character limit	5,000 (description); title 100
Media	Required — video only
Placements	None
Comments	Coming soon
Direct messages	No
Post chains	No

Publishing

Parameters

Parameter	Type	Required	Description
`privacy_status`	string	Yes	`public`, `unlisted`, or `private`
`title`	string	No	Video title (max 100 characters)
`cover_url` / `cover_file`	string / file	No	Custom thumbnail (requires a verified YouTube account)
`made_for_kids`	boolean	No	Whether the video is made for kids
`tags`	array	No	Tags for the video
`category_id`	string	No	YouTube category ID (defaults to `"22"`, People & Blogs)
`contains_synthetic_media`	boolean	No	Disclose altered or AI-generated content

Media	Max size	Formats	Count	Duration
Video	256 GB	mp4, mov, avi, wmv, flv, 3gp	1	1 s+

A video is required; images are not accepted.
The post body becomes the video description.

Privacy status

Value	Visibility
`public`	Everyone
`unlisted`	Anyone with the link
`private`	Only you

# Public upload with a custom thumbnail
curl -X POST "https://api.postproxy.dev/api/posts" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "post": { "body": "Check out our latest tutorial on building API integrations!" },
       "profiles": ["prof_abc123"],
       "media": ["https://example.com/video.mp4"],
       "platforms": {
         "youtube": {
           "title": "How to Build an API Integration",
           "privacy_status": "public",
           "cover_url": "https://example.com/custom-thumbnail.jpg"
         }
       }
     }'

# Unlisted upload with tags and a category
curl -X POST "https://api.postproxy.dev/api/posts" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "post": { "body": "Internal demo recording." },
       "profiles": ["prof_abc123"],
       "media": ["https://example.com/demo.mp4"],
       "platforms": {
         "youtube": {
           "title": "Q3 Demo",
           "privacy_status": "unlisted",
           "tags": ["demo", "product"],
           "category_id": "28",
           "made_for_kids": false
         }
       }
     }'

Comments

Coming soon. Comment list, reply, hide, and delete support for YouTube is in progress. When live, comments will be managed through the Comments API.

Direct messages

Not supported.

Webhooks

Subscribe with the Webhooks API:

curl -X POST "https://api.postproxy.dev/api/webhooks" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "url": "https://example.com/webhooks/postproxy",
       "events": ["platform_post.published", "platform_post.failed", "platform_post.insights"]
     }'

Events relevant to YouTube:

Event	When
`post.processed`	A post is ready to publish
`platform_post.published`	A post was published to the platform
`platform_post.failed`	A post failed to publish (retries exhausted)
`platform_post.failed_waiting_for_retry`	A publish attempt failed; will retry
`platform_post.insights`	New analytics snapshot
`profile.connected` / `.disconnected`	Connection state changed
`profile.stats`	New profile stats snapshot
`media.failed`	A media attachment failed to process

Notes

privacy_status is required on every upload.
A custom thumbnail (cover_url / cover_file) requires a verified YouTube account.
Set contains_synthetic_media: true to disclose AI-generated or altered content, per YouTube policy.