View as Markdown
YouTube Data icon

YouTube Data ACTION

Upload Video

Post a video to your channel. See the documentation for more information
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's YouTube Data account once, then configure and run Upload Video from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "youtube_data_api-upload-video",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    youtube_data_api: { authProvisionId: "apn_xxxxxxx" },
    title: "Title",
    description: "Description",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Upload Video inputs
Property Type Description
title Title string
The video's title
Required
description Description string
The video's description
Required
filePath File Path or URL string
Provide either a file URL or a path to a file in the /tmp directory (for example, /tmp/myFile.pdf).
Required
privacyStatus Privacy Status string
The video's privacy status
Optional
publishAt Publish At string
The date and time when the video is scheduled to publish. If you set this, the Privacy Status must be set to private. Only available to Youtube Partner accounts.
Optional
tags Tags string[]
A list of keyword tags associated with the video. Tags may contain spaces.
Optional
notifySubscribers Notify Subscribers boolean
Set to true if YouTube should send a notification about the new video to users who subscribe to the video's channel.
Optional
syncDir SyncDir dir
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
youtube_data_api-upload-video
Version
1.0.2
App
YouTube Data
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes