Skip to Content
DocumentationUser guideIntegrationsVideo distributionYouTube iconYouTube

YouTube

YouTube is a video hosting platform that allows users to upload, share, and manage videos. It provides tools for video distribution, analytics, and customization.

The following video distribution integrations are available for YouTube:

  • Upload to YouTube - upload a video to a specified YouTube channel once a rendering is done successfully.
  • Upload to YouTube and notify - does everything the standard upload does and, once the upload succeeds, sends a POST request to your webhook with the resulting YouTube video details.

Setup

Configure upload to YouTube

When setting up the Upload to YouTube integration, you will need to provide the following information:

  1. Google account - link the Google account you want to use and provide permissions to Plainly to access your YouTube.
  2. Title - define the title of the video. If you want to use a parameter from a render request as the title, you will need to use the Integration passthrough option.
  3. Description - define a video description.
  4. Category - select a category for your video.
  5. Tags - set up tags for your video.
  6. Default language - select a language of the video.
  7. Publish at - specify a date in future at which the video will become public.
  8. Privacy status - select a privacy status of your video on upload.
  9. License - select a video distribution license.
  10. Embeddable - if enabled, viewers will be able to embed this video to 3rd party websites.
  11. Notify subscribers - if enabled, your subscribers will get a notification once a video is uploaded using this integration.
  12. Public stats viewable - if enabled, viewers will see stats of this video.
  13. Self declare made for kids - if enabled, this video will be labeled as This video is for kids. This can imply additional checks & restrictions by YouTube.

Clicking on the + button will show all available variables which you can use to customize the fields.

Read the Video distribution section to learn more about available variables.

Configure notification webhooks

Use the Upload to YouTube and notify integration when you want Plainly to notify an external system as soon as the upload is done. Besides the setup steps listed above, you will also provide an HTTPS endpoint that Plainly will call with a JSON payload. By default, the payload contains the YouTube integration execution results, including the videoId and videoUrl:

Default notification payload
{
	"videoId": "2abCDeF",
	"videoUrl": "https://youtu.be/2abCDeF"
}

Use the + button next to the Request body field to pull in additional variables from the render request or the integration execution context into your notification payload.

Note that you have full control over the notification POST request setup. You can use form data, custom headers, and other HTTP request options to tailor the notification to your needs.

Vimeo iconVimeoVideoGenius