step by step
How to post to YouTube with the API
Create a key, connect YouTube, then schedule a video.
Open Dashboard → AI & API, create a key, and send it as Authorization: Bearer pw_live_…. Connect your YouTube account if you have not already.
Endpoints
API base URL
https://postwing.io/api/v1Docs
https://postwing.io/docsCall POST /posts/preview with a video, time, and a YouTube target that includes a required title. Full field reference is in the API docs.
curl -s -X POST "https://postwing.io/api/v1/posts/preview" \
-H "Authorization: Bearer pw_live_…" \
-H "Content-Type: application/json" \
-d '{
"caption": "Description from the YouTube posting API",
"scheduled_at": "2026-10-05T18:00:00Z",
"targets": [
{
"account_id": "youtube-account-uuid",
"platform_options": {
"title": "My video title",
"made_for_kids": false
}
}
],
"media_items": [
{
"url": "https://cdn.example.com/video.mp4",
"type": "video"
}
]
}'what you can do
YouTube posting from one API
Same PostWing API as the full product, scoped to YouTube when you target a YouTube account.
- Schedule YouTube videos and Shorts
- Upload video with a direct upload URL
- Set a required title and made_for_kids flag
- Optional custom covers with thumbnail_url
- Edit or cancel scheduled YouTube posts from the same API
built for YouTube
Titles and Shorts in one flow
Upload a video, set the title, pick a time, and target YouTube. Captions map to the video description.
- Video-only publishing for YouTube
- Optional custom covers with thumbnail_url
- Scheduled videos show up on your PostWing calendar
YouTube options
Platform settings that matter
Pass these on targets[].platform_options. Title is required for YouTube.
titlerequired Shorts or long-form titlemade_for_kidswhether the video is made for kids- Preview → confirm so nothing schedules without approval
- API key or OAuth with scoped access
one API
Same API for every network
There is no separate YouTube product. Pass platforms or targets[] on the same preview → confirm flow. Add Instagram, TikTok, YouTube, LinkedIn, X, Facebook, Pinterest, or Threads without changing your integration.
- Threads
- TikTok
- X (Twitter)
- YouTube
Connect accounts once in PostWing (or via the accounts endpoints)
Call POST /posts/preview with the networks you want on that post
Confirm with the token. One key covers every platform PostWing supports.
questions
YouTube posting API FAQ
Yes. Upload a vertical video, set a title on targets[].platform_options, then preview and confirm. Shorts follow YouTube’s usual length and format rules.