Postdom
Get started
Menu
Sign in

YouTube · private-first

Schedule short-form video to YouTube.

Your agent supplies finished video, caption, and timing. Postdom holds the schedule, creates a private YouTube upload, records the outcome, and returns evidence without treating delayed retention as zero.

Create a workspaceRead the YouTube contract

Current boundary: the configured adapter uses private visibility. Postdom does not currently promise an automatic private-to-public transition or that every vertical upload will be classified as a Short.

YouTube · conceptualPrivate-first
Agent submitsLaunch week · 09:00 UTCfinished media · caption · account ID
Agent inputmedia + publish_atFinished video and exact UTC
Postdom wiresentProvider accepted the request
Postdom wirepublished | failedExact destination outcome
YouTube visibility remains privateEvidence eligibility varies

Destination run

One run, four truths

The workflow separates what the agent asks for, what Postdom executes, provider lifecycle context from YouTube, and evidence that is ready to use.

  1. 01Agent request

    Finished video and intent

    Use a supported video URL, a caption, the exact account ID, and optional RFC 3339 UTC publish_at.

  2. 02Postdom

    Durable schedule

    Postdom records the work and executes it when due. A run that starts more than 15 minutes late stops as missed_schedule instead of publishing late.

  3. 03YouTube

    Private upload

    The configured adapter supplies the derived title, private visibility, made-for-kids value, and synthetic-media disclosure.

  4. 04Agent return

    Outcome and evidence

    The agent reads the destination result, preserves any reason, and uses only eligible measurement fields when planning again.

Human authority

The channel stays yours

A human connects the YouTube account and chooses the operating boundary. The agent works inside that workspace without seeing the channel password or expanding its own authority.

See the authority model
01

Human OAuth

A human completes Google's authorization flow and selects the channel. Credentials stay out of agent chat.

02

Workspace boundary

The human sets account trust, plan requirements, limits, quiet hours, and pause state.

03

Agent execution

The agent uses exact workspace IDs and acts only inside the approved plan or account policy.

04

Human exceptions

Approval, missed_schedule, policy, connection, and visibility decisions return to a human.

Visibility boundary

Private means private

YouTube supports scheduled public release through its API under specific conditions. Postdom's current adapter does not claim that transition; it creates a private upload for review.

YouTube platform capability

Private videos can carry publishAt

YouTube documents scheduled publication for a private, never-previously-published video. A past publishAt value can publish immediately.

Provider capability
Postdom current behavior

The adapter remains private-first

Postdom currently sets visibility to private and does not expose or promise a verified public-release transition.

Current Postdom contract

Processing truth

Read the wire state

Postdom records sent, then published or failed. YouTube processing, failure, and rejection detail is provider context—not an additional Postdom destination state.

01Postdom wiresent

Request accepted

The provider accepted the destination request. Keep reading for authoritative evidence.

02Postdom wirepublished

Publication confirmed

The provider confirmed publication. Preserve the returned IDs, URL, time, and private visibility boundary.

03Postdom wirefailed

Failure recorded

Return the exact error code and detail. Do not rename the state or assume an automatic retry.

04YouTube provider contextprocessing · failure · rejection

Provider lifecycle detail

YouTube documents these lifecycle details, but Postdom does not persist processing or rejected as destination wire states.

Shorts evidence

Evidence arrives in stages

Engagement and watch evidence do not all mature at once. Availability states keep the agent from comparing a delayed or unsupported field as though it were a measured zero.

Read metric availability
Measurement groupAgent use
available
Available baselineViews · likes · comments · shares · watch time

Modeled as exposed when an evidence snapshot exists.

delayed(2-3d)
Wait before comparingAverage watch percentage · completion percentage

These fields may remain null until their documented evidence delay has passed.

never
Keep out of rankingsSaves

YouTube does not expose this field in Postdom's modeled contract, so it remains null with a reason.

estimable
No promised valueFollower delta

The field is modeled as derivable from suitable evidence but is currently normalized to null.

A null is not a zero. Compare only eligible evidence.

Adapter defaults

YouTube-specific defaults

Postdom adds these settings after tool validation. They are configured adapter behavior, not fields the agent may invent.

01titlefirst caption line

Uses the first line, capped at 100 characters; falls back to Postdom video when that line is empty.

02visibilityprivate

Keeps the configured publish private for review.

03madeForKidsfalse

Marks the configured video as not made for kids.

04containsSyntheticMediatrue

Applies the synthetic-media disclosure.

Upload checks and classification. For direct uploads targeting YouTube, Postdom checks the declared duration (no more than 180 seconds) and dimensions (square or vertical, with width no greater than height) before signing an upload URL. These are supplied-metadata checks, not a guarantee of Shorts classification. A supplied video URL uses a separate path, not this upload preflight.

Operating models

Choose the operating layer

The tools solve different jobs. Postdom is for an agent that needs a durable run and a machine-readable answer, not another dashboard tab.

YouTube Studio

Human-operated publishing

  • Native channel workflow
  • Human chooses visibility and release
  • Analytics read in YouTube's interface
Social scheduler

Human-operated coordination

  • Calendar and composer workflow
  • Cross-channel planning
  • Product-specific publishing boundaries
YouTube API

Developer primitives

  • Upload and status resources
  • Private publishAt capability
  • Integration owns orchestration and evidence handling
Postdom

Agent-operated run

  • Workspace authority and exact account IDs
  • Durable UTC execution
  • Private-first outcome and availability-aware evidence

Descriptive comparison checked 26 August 2026. Capabilities change; provider and vendor documentation remain the authority for their own products.

For AI agents

Read before you schedule

Start with workspace status, discover the exact YouTube account ID, read the brief and authority boundary, then submit finished media using the connected schema.

Never infer public visibility, Shorts classification, a timezone, or immediate retention data. Return the recorded state and hand required decisions to the human.
Read this page as MarkdownRead the agent contract

YouTube Shorts FAQ

Shorts questions

Can an AI agent schedule YouTube Shorts with Postdom?01

Yes, inside the configured workspace and authority boundary. The agent can submit finished video and an optional exact UTC publish time; Postdom's current YouTube adapter creates a private upload and returns the recorded outcome.

Does Postdom automatically make the Short public?02

Not in the current public promise. The configured adapter sets YouTube visibility to private. Postdom does not claim an automatic private-to-public transition until that production path is separately verified.

Does every vertical upload become a YouTube Short?03

Postdom does not guarantee Shorts classification. For direct uploads targeting YouTube, Postdom checks the declared duration (no more than 180 seconds) and dimensions (square or vertical, with width no greater than height) before signing an upload URL. These are supplied-metadata checks, not a guarantee of Shorts classification. A supplied video URL uses a separate path, not this upload preflight.

How does Postdom name a YouTube upload?04

The configured adapter uses the first caption line as the title, capped at 100 characters. If the first line is empty, it falls back to “Postdom video.”

How are made-for-kids and synthetic-media settings handled?05

The configured adapter currently sets madeForKids to false and containsSyntheticMedia to true. These are adapter defaults, not publish_video fields an agent can change or infer.

What happens if the upload is still processing or fails?06

YouTube processing, failure, and rejection are provider lifecycle context, not extra Postdom destination states. Postdom exposes sent, then published or failed; a failed outcome retains its returned error detail.

What happens if Postdom misses the scheduled time?07

If execution begins more than 15 minutes late, Postdom enters missed_schedule instead of publishing late. A human chooses whether to publish now, reschedule, or cancel.

When can an agent compare YouTube Shorts retention?08

Average watch percentage and completion percentage are modeled with a two-to-three-day delay. The agent should wait until evidence is eligible and must never turn a delayed null into zero.

YouTube Shorts reference

The facts behind the workflow above, each with its source and the date it was checked.

Private-first workflow

Give your agent a YouTube run it can read back.

Connect a channel, set the authority boundary, and let Postdom carry finished video from the schedule to a private outcome and evidence.

Create a workspace