Overview

Onepostly maps the YouTube Data API v3 (plus Analytics) into the same /v1/* surface as other platforms. This section covers YouTube-only behavior.

Publishing is video-only — there is no text or image post type on YouTube.

In this section

Page	Topics
Posts	Upload videos / Shorts; visibility; schedule; remote delete
Comments	List and create comments
Engagement	Like / unlike
Insights	Views, likes, comments, shares

Cross-platform API flow: Media, Webhooks.

Connect

Dashboard → Connections → connect YouTube
Approve Google OAuth scopes and pick the Google account that owns the channel
Resolve connectionId with your API key:

curl https://api.onepostly.com/v1/connections \
  -H "x-api-key: op_YOUR_KEY"

Use the matching row’s id (where platform is "youtube") as connectionId.

The Google account must already have a YouTube channel.

OAuth scopes

Scope	Used for
`https://www.googleapis.com/auth/youtube.upload`	Upload videos
`https://www.googleapis.com/auth/youtube.force-ssl`	Comments + like/unlike
`https://www.googleapis.com/auth/yt-analytics.readonly`	Analytics

Auth errors

Code	Meaning
`TOKEN_INVALID` / `401`	Expired token → reconnect
`PERMISSION_DENIED` / `403`	Missing scope, quota, or unverified app restrictions

Capabilities

Action	Supported	Notes
Create post	Yes	Video only
Text / image / multi-image / stories	No	`UNSUPPORTED_MEDIA_KIND`
Shorts	Yes	Vertical ≤60s video; optional `#Shorts` in title
Visibility	Yes	`destinations[].privacyStatus`: `public` / `unlisted` / `private`
Schedule	Yes	`scheduledFor` + `timezone`
Remote delete	Yes	`DELETE …/destinations/:id`
Insights	Yes
List / create / delete comments	Yes
Like / unlike	Yes
Bookmark / retweet	No

Known limitations

Default Google Cloud quota: 10,000 units/day; each upload costs 1,600 (~6 uploads/day before other calls)
Unverified OAuth clients may upload videos as private (locked) until Google verification
Onepostly publish path caps video size at 256 MB