Titles, tags, privacy and Shorts: upload YouTube video through API
One authenticated POST lets you upload YouTube video through API with a title, up to 20 tags, a privacy status and an existing playlist id attached. YouTube is video-only here - no Community posts, no image or text posts - so the payload is small and the rules are strict.
Every YouTube-specific option sits in one object
youtubeConfigs carries postType, videoTitle, tags, categoryId, privacyStatus, playlistId and the notify/embed/kids/license flags, and it rides on the same POST /social-posts request that references the uploaded file.
Trusted by Creators and Teams
See how creators, marketers, and small businesses use AdaptlyPost to stay consistent and save hours every week.
I'm a software engineer, not a marketer. My partner runs a TikTok page, so I help out by scheduling her posts, I batch everything in one sitting and let the AI handle the captions. Takes me about 20 minutes a week now.
Software Engineer
I run my nail art page and a personal brand. Scheduling both from one dashboard changed everything, I actually post consistently now and my engagement went up pretty noticeably within a month.
Content Creator
I'm an SWE and honestly terrible at posting consistently. I just line up a week of updates for my personal brand whenever I have a spare minute, and the AI drafts captions per platform so I'm not rewriting the same thing five different ways.
Software Engineer
I'm a software engineer, not a marketer. My partner runs a TikTok page, so I help out by scheduling her posts, I batch everything in one sitting and let the AI handle the captions. Takes me about 20 minutes a week now.
Software Engineer
I run my nail art page and a personal brand. Scheduling both from one dashboard changed everything, I actually post consistently now and my engagement went up pretty noticeably within a month.
Content Creator
I'm an SWE and honestly terrible at posting consistently. I just line up a week of updates for my personal brand whenever I have a spare minute, and the AI drafts captions per platform so I'm not rewriting the same thing five different ways.
Software Engineer
I'm a software engineer, not a marketer. My partner runs a TikTok page, so I help out by scheduling her posts, I batch everything in one sitting and let the AI handle the captions. Takes me about 20 minutes a week now.
Software Engineer
I run my nail art page and a personal brand. Scheduling both from one dashboard changed everything, I actually post consistently now and my engagement went up pretty noticeably within a month.
Content Creator
I'm an SWE and honestly terrible at posting consistently. I just line up a week of updates for my personal brand whenever I have a spare minute, and the AI drafts captions per platform so I'm not rewriting the same thing five different ways.
Software Engineer
I'm not a social media person but I need to post my work somewhere. The AI writer drafts something decent, I tweak it a bit, schedule it, done. Went from posting once a month to three times a week.
Freelance Designer
We connected our OpenClaw agent to AdaptlyPost and now our AI posts product updates across all channels automatically. It sounds futuristic but honestly it just works. The API integration was straightforward.
Startup Founder
I'm not a social media person but I need to post my work somewhere. The AI writer drafts something decent, I tweak it a bit, schedule it, done. Went from posting once a month to three times a week.
Freelance Designer
We connected our OpenClaw agent to AdaptlyPost and now our AI posts product updates across all channels automatically. It sounds futuristic but honestly it just works. The API integration was straightforward.
Startup Founder
I'm not a social media person but I need to post my work somewhere. The AI writer drafts something decent, I tweak it a bit, schedule it, done. Went from posting once a month to three times a week.
Freelance Designer
We connected our OpenClaw agent to AdaptlyPost and now our AI posts product updates across all channels automatically. It sounds futuristic but honestly it just works. The API integration was straightforward.
Startup Founder
From empty terminal to published upload
Create a key, then look up the channel
Keys are issued in the dashboard under Settings > API Tokens and start with adaptly_. Send them as `Authorization: Bearer <key>` against https://post.adaptlypost.com/post/api/v1. The channel itself is connected over OAuth in the dashboard - there is no endpoint that connects, disconnects or health-checks a YouTube channel - and then `GET /social-accounts` returns its id, platform and displayName to reference in the post. One call targets one YouTube channel: a second channel is a second call, and sending two YouTube accounts in one payload is rejected with a 400.
Push the file, then POST /social-posts with youtubeConfigs
Only video/mp4 and video/quicktime are accepted, and `POST /upload-urls` rejects any other mime type outright, so request presigned URLs there (1-20 files, valid for one hour), PUT the file, and create the post with `text`, `platforms: ["YOUTUBE"]`, `timezone` (IANA, e.g. "Europe/Berlin"), `contentType: "VIDEO"` and a `youtubeConfigs` object. YouTube's supported content type list is VIDEO and its max images per post is 0, so an IMAGE or TEXT post that includes YouTube never reaches the channel. The request body is validated synchronously: `videoTitle` past 100 characters, more than 20 `tags`, a missing required field or an unsupported content type all come back as a 400 on the create call itself, with no post record written and nothing to retry. `postType: "SHORTS"` requires a 9:16 file of 60 seconds or less, so check aspect ratio and duration before you call. Add `scheduledAt` to schedule instead of publishing immediately.
Read platformPostId, or fix and retry
`GET /social-posts/:id/results` returns the YouTube entry with `status`, `publishedAt`, `errorMessage` and `platformPostId` - the raw YouTube video id. No watch URL is ever returned, so build the link yourself from that id. This endpoint reports what YouTube did after we accepted and dispatched the upload, not whether the payload was well formed - malformed payloads never get this far, because they failed with a 400 at create. What shows up in `errorMessage` is channel-side: a `playlistId` that does not exist on the connected channel, an OAuth grant the channel owner revoked, or an upload YouTube refused or throttled during its own processing. Fix the underlying cause and call `POST /social-posts/:id/retry` with the failed `platformIds` rather than recreating the post. There is no sandbox anywhere in the API, so the closest thing to a dry run is publishing with `privacyStatus: "PRIVATE"` and flipping it in YouTube Studio afterwards.
Simple, transparent pricing
Choose the perfect plan for your needs
30 connected social accounts
Unlimited scheduled posts
1 team member
3 workspaces
150 credits/month
AI Captions
AI Image Studio
API access & OpenClaw integration
Image, video & carousel posts
Most Popular
60 connected social accounts
Unlimited scheduled posts
5 team members
15 workspaces
400 credits/month
AI Captions
AI Image Studio
API access & OpenClaw integration
Image, video & carousel posts
100 connected social accounts
Unlimited scheduled posts
20 team members
50 workspaces
1000 credits/month
AI Captions
AI Image Studio
API access & OpenClaw integration
Image, video & carousel posts
All plans include a 7-day free trial
Want to see the full feature comparison? View pricing page
What you can actually set on a YouTube upload
Long-form uploads with metadata attached
`postType: "VIDEO"` publishes a standard upload. `videoTitle` sets the title with a 100-character ceiling, `tags` takes up to 20 strings, `categoryId` takes YouTube's numeric category id, and the post `text` travels with the video as its body copy. Nothing beyond that object is settable: there are no thumbnail, chapter, end-screen, caption or premiere fields in this API.
Shorts on the same endpoint
Switch `postType` to `"SHORTS"` to upload YouTube Shorts via API - same endpoint, same youtubeConfigs, same upload-urls pipeline. The deciding constraint is the media, not the flag: a Short requires a 9:16 aspect ratio and a duration of 60 seconds or less, so validate dimensions and duration before you call rather than after.
Privacy, notifications and the audience flag
`privacyStatus` accepts PUBLIC, UNLISTED or PRIVATE. `notifySubscribers` decides whether the channel's subscribers are pinged, `allowEmbedding` sets embed permission, `madeForKids` carries the audience designation, and `license` sets the video license. All of them are per-post, so a backlog of archive uploads can go out private and silent while one launch video goes public and notifies.
Adding the upload to an existing playlist
Set `playlistId` in youtubeConfigs and the finished upload is filed into that playlist. It has to exist already - the API can add to a playlist but cannot create, rename, reorder or list one - so copy the id out of YouTube Studio (the `list=` value in the playlist URL) and store it in your own config. If the id is wrong, that shows up on the YouTube entry returned by `/results`.
Wire up your first YouTube upload
Create a key in Settings > API Tokens, import GET /openapi.json into your HTTP client, Make or n8n, and the first upload is one POST away. Test with privacyStatus PRIVATE before you go public.