Skip to main content

Host Videos on Vimeo

Vimeo, a cloud-based video hosting platform, allows you to host and share your videos.

This integration allows you to effortlessly upload your videos to Vimeo.

Setup​

To send your videos directly to your Vimeo account you will have to connect Shotstack to your Vimeo Account. This will provide Shotstack with permissions to upload videos to Vimeo on your behalf.

Login to the dashboard and navigate to the integrations page, find the Vimeo destination and click configure.

Click the Connect to Vimeo button and follow the prompts.

Vimeo Credentials

Integration​

Basic integration​

To send files to Vimeo add the following to the output parameter of the render payload:

"destinations": [{
    "provider": "vimeo"
}]

The following will set a name and description for your video and send the rendered videos to your Vimeo account:

"destinations": [{
    "provider": "vimeo",
    "options": {
        "name": "My Automated Video",
        "description": "This video was uploaded via Shotstack"
    }
}]

Set folder​

Shotstack allows you to send videos to a folder inside Vimeo:

"destinations": [{
    "provider": "vimeo",
    "options": {
        "name": "My Automated Video",
        "description": "This video was uploaded via Shotstack",
        "folderUri": "/users/{user_id}/folders/{project_id}"
    }
}]
Info

Review the Vimeo documentation for more information on how to manage folders.

Setting video permissions​

Shotstack allows you to set the permissions of your videos:

"destinations": [{
    "provider": "vimeo",
    "options": {
        "name": "My Automated Video",
        "description": "This video was uploaded via Shotstack",
        "permissions": {
            "view": "anybody",
            "embed": "public",
            "comments": "anybody"
        }
    }
}]

The available options are:

  • view: 'anybody', 'nobody', 'contacts', 'unlisted'
  • embed: 'public', 'private', 'whitelist'
  • comments: 'anybody', 'nobody', 'contacts'

Opting out from the Shotstack destination​

By default all generated files are sent to the Shotstack destination. If you are using Vimeo you may wish to opt out from hosting your videos with Shotstack using:

"destinations": [{
    "provider": "vimeo",
    "options": {
        "folderId": "2t-eTY12LO8tzQLAwMug-fIrK_7AQBI6B"
    }
},{
    "provider": "shotstack",
    "exclude": true
}]

This will send the generated video to Vimeo but not to Shotstack.