Overview
This node allows users to upload videos to Vimeo directly from n8n workflows. It supports uploading video files either from binary data within the workflow or from a local file path on the machine running n8n. Users can optionally specify a title and description for the uploaded video.
Common scenarios include automating video publishing pipelines, such as uploading recorded webinars, marketing videos, or user-generated content to Vimeo without manual intervention. For example, after processing or generating a video in a previous workflow step, this node can upload it to Vimeo and return the video's URL for further use.
Properties
| Name | Meaning |
|---|---|
| Operation | The action to perform; currently only "Upload Video" is supported. |
| Source | Where to read the video from: either "Binary Property" (video data from workflow binary) or "Local File Path" (a file on disk). |
| Binary Property | (If Source is "Binary Property") The name of the binary property containing the video data. |
| File Path | (If Source is "Local File Path") Absolute or relative path to the local video file. |
| Title | Optional title to set on the uploaded video. |
| Description | Optional description to set on the uploaded video. |
Output
The node outputs an array of JSON objects, each representing one uploaded video item with the following fields:
videoUri: The Vimeo API URI of the uploaded video resource.link: The public or shareable link to the uploaded video on Vimeo.name: The title provided by the user or the original filename if no title was set.mimeType: The MIME type of the uploaded video (e.g., "video/mp4").fileName: The original filename of the uploaded video.
No binary data is output by this node.
Dependencies
- Requires an API key credential for Vimeo with permissions to upload videos.
- Uses Vimeo's TUS protocol-based resumable upload endpoint (
https://api.vimeo.com/me/videos). - Requires access to the local filesystem if using the "Local File Path" source option.
- Node uses internal helper methods for authentication and HTTP requests configured with the Vimeo API credentials.
Troubleshooting
- Missing Binary Property: If the specified binary property does not exist in the input item, the node will throw an error indicating the missing property. Ensure the binary data is correctly named and passed into the node.
- File Path Required: When using the local file path source, the file path must be valid and accessible by the n8n process. Errors occur if the file is missing or unreadable.
- Failed to Initialize Vimeo Upload: This error indicates that the initial request to Vimeo to start the upload session failed. Check API credentials, network connectivity, and Vimeo account permissions.
- HTTP Request Failures: Network issues or invalid credentials may cause upload failures. Verify API keys and internet access.
- Continue On Fail: If enabled, the node will continue processing subsequent items even if some fail, returning error messages in the output JSON.