YouTube

Requirements

Use a connected YouTube channel with youtube.upload permission and no reconnection flag. Check capabilities.publishPosts or schedulePosts; if unavailable, review the granted upload permission and reconnect in Posteady. Use one confirmed video from the channel’s workspace.

Supported formats

Use only accountIds and a youtube object for immediate publishing. title, mediaId, requestId, and privacyStatus are required. description and madeForKids are optional. Visibility can be public, unlisted, or private.

For formats that need media, complete the upload guide: reserve → PUT → confirm. Only confirmed mediaId values can be published.

Publish a post

Account and media UUIDs are illustrative; replace them with real IDs. Set your API key in the POSTEADY_API_KEY environment variable.

curl --request POST "https://www.posteady.com/api/v1/posts" \
  --header "Authorization: Bearer $POSTEADY_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "accountIds": [
    "11111111-1111-4111-8111-111111111111"
  ],
  "youtube": {
    "requestId": "33333333-3333-4333-8333-333333333333",
    "mediaId": "22222222-2222-4222-8222-222222222222",
    "title": "A look behind the scenes",
    "description": "How we built our latest release.",
    "privacyStatus": "public",
    "madeForKids": false
  }
}'

Confirm success

HTTP 202 means the job was accepted. Store results[0].jobId, then read its status below and wait for status: published. Replace the illustrative ID with the returned value.

curl --request GET "https://www.posteady.com/api/v1/publish-jobs/44444444-4444-4444-8444-444444444444" \
  --header "Authorization: Bearer $POSTEADY_API_KEY"

Scheduling and related tasks

To schedule, send the same platform input to /scheduled-posts with a future scheduledAt and optional timezone. For asynchronous platforms, generate a UUID requestId per operation and retain it for retries.

Schedule and cancel · Read posts and metrics · Retries · MCP tools

Limits and errors

Titles allow 1–100 UTF-16 code units; descriptions allow 5,000. Videos must be MP4/QuickTime, no larger than 500 MiB (524,288,000 bytes), and no longer than 12 hours. madeForKids defaults to false; set it to match your content’s audience. Reposts and first comments are unsupported. Job errors include ACCOUNT_UNAVAILABLE, MEDIA_UNAVAILABLE, PUBLISH_QUOTA_EXCEEDED, PREPARATION_FAILED, PUBLISH_FAILED, and PUBLISH_RESULT_UNKNOWN. Check YouTube Studio before making a new request after an unknown outcome.

Publishing reference · Troubleshooting