Skip to main content
This guide shows you how to create videos with Pictory and automatically upload them to Vimeo with custom privacy settings, content ratings, and folder organization. Perfect for streamlining your video workflow.

What You’ll Learn

Auto Upload

Automatically upload videos to Vimeo

Privacy Controls

Configure view, embed, and download settings

Folder Organization

Organize videos in Vimeo folders

Content Ratings

Set appropriate content ratings

Before You Begin

Make sure you have:
  • A Pictory API key
  • Node.js or Python installed on your machine
  • A Vimeo account with API access
  • Vimeo connection created in Pictory (see setup below)

How Vimeo Integration Works

When you create a video with Vimeo destination:
  1. Video Creation - Your video is created by Pictory API
  2. Connection Verification - Vimeo connection is validated
  3. Privacy Setup - Your specified privacy settings are configured
  4. Folder Assignment - Video is placed in designated Vimeo folder (if specified)
  5. Upload Process - Video is automatically uploaded to Vimeo
  6. Response Delivery - Both Pictory and Vimeo URLs are returned
You must create a Vimeo connection before using this feature. The connection authorizes Pictory to upload videos to your Vimeo account on your behalf.

Setting Up Vimeo Connection

Before creating videos with Vimeo integration, set up your connection:

Step 1: Create Vimeo Connection

Step 2: List Your Connections

See Create Vimeo Connection for detailed setup instructions.

Complete Example

Understanding the Parameters

Main Request Parameters

Destination Configuration

Privacy Settings

Control who can view, embed, and interact with your video:

View Privacy Options Explained

Embed Privacy Options

Content Rating Options

Tag your video with appropriate content ratings:
You can specify multiple content ratings. For example: ["safe", "advertisement"] for a family-friendly commercial.

Common Use Cases

Public Marketing Video

Result: Video is public, embeddable, and allows comments.

Unlisted Shareable Video

Result: Video accessible via link, embeddable, but not listed publicly.

Private Client Review

Result: Password-protected video for client review with download option.

Team-Only Training Video

Result: Private video only viewable by Vimeo contacts.

Best Practices

Protect your Vimeo access credentials:
  • Secure Storage: Store Vimeo access tokens securely, not in code
  • Environment Variables: Use environment variables for sensitive data
  • Connection Names: Use descriptive names for multiple connections
  • Regular Rotation: Periodically rotate access tokens
  • Test First: Verify connection works before production use
Select privacy settings based on your use case:
  • Public Content: Use anybody view + public embed
  • Shareable but Private: Use unlisted view
  • Team Only: Use contacts or users view
  • Client Reviews: Use password view with download enabled
  • Work in Progress: Use nobody view until ready
Use Vimeo folders for better organization:
  • Get Folder URI: Navigate to folder in Vimeo, check URL for URI
  • Consistent Structure: Create logical folder hierarchy
  • By Project: Organize by client, campaign, or project
  • By Type: Separate by content type (marketing, training, etc.)
  • Pre-Create Folders: Set up folders in Vimeo before API use
Tag videos appropriately:
  • Be Honest: Accurate ratings help with content discovery
  • Multiple Tags: Use multiple ratings when applicable
  • Safe Tag: Use for family-friendly content
  • Advertisement: Always tag commercial content
  • Review Guidelines: Follow Vimeo’s community guidelines
You can upload to multiple platforms:
  • Multiple Destinations: Specify up to 5 destinations per video
  • Different Settings: Each destination can have unique settings
  • Error Handling: One destination failure does not stop others
  • Track URLs: Response includes URLs for all destinations
  • Verify All: Check each destination uploaded successfully

Troubleshooting

Problem: API returns error about invalid or missing connection.Solution:
  • Verify connection ID is correct
  • Use Get Vimeo Connections API to list valid connections
  • Ensure connection hasn’t been deleted
  • Check Vimeo access token is still valid
  • Re-create connection if necessary
  • Ensure you are using the ID, not the connection name
Problem: Video is created successfully but does not appear on Vimeo.Solution:
  • Check job response for destination upload status
  • Verify Vimeo connection has upload permissions
  • Check Vimeo account storage quota
  • Review Vimeo API rate limits
  • Verify folder URI exists in your Vimeo account
  • Check destinations array in response for error messages
Problem: Video uploads but privacy settings are different than specified.Solution:
  • Verify privacy object syntax is correct
  • Check Vimeo account permissions (some settings require paid plans)
  • Ensure password is provided if view is set to “password”
  • Confirm whitelist domains if embed is “whitelist”
  • Review Vimeo’s default settings for your account
Problem: Video does not appear in specified Vimeo folder.Solution:
  • Get folder URI from Vimeo folder URL (e.g., /videos/123456)
  • Ensure folder exists in your Vimeo account before uploading
  • Check folder permissions (you must be owner or have access)
  • Try omitting folder_uri to upload to account root first
  • Verify folder URI format starts with /videos/
Problem: Video processing completes but Vimeo upload is slow.Solution:
  • Vimeo upload time depends on video size and length
  • Large videos (over 1GB) may take 15-30 minutes additional time
  • Check your internet connection speed
  • Vimeo may be processing the video on their end
  • Monitor job status - it will show “completed” when fully done
  • Consider reducing video resolution/quality if uploads consistently timeout
Problem: Video created but all destination uploads fail.Solution:
  • Check destinations array is properly formatted
  • Ensure each destination has required type parameter
  • Verify connection IDs for all destination types
  • Test with single destination first
  • Check API response for specific destination errors
  • Ensure destination limit (5 max) is not exceeded

Next Steps

Explore more advanced features and integrations:

AWS S3 Integration

Upload videos to AWS S3 storage

Background Music

Add music to your videos

Intro/Outro Videos

Add branded intro and outro sequences

Save Project

Save video projects for later editing

API Reference

For complete technical details on Vimeo integration, see: