Vimeo

Overview

The Vimeo integration enables video hosting and delivery for your podcast episodes. Upload finished video episodes, generate private review links, and embed videos in your client portal — all managed from within preroll.io.

OAuth2 Setup

Register Your Application

1. Go to the Vimeo Developer Portal
2. Create a new app
3. Under Authentication, configure OAuth 2.0:

4. Note your Client ID and Client Secret

Environment Variables

VIMEO_CLIENT_ID=your_client_id
VIMEO_CLIENT_SECRET=your_client_secret

Connecting Your Account

1. Go to Settings → Integrations
2. Click Connect next to Vimeo
3. Authorize preroll.io to access your Vimeo account
4. Your Vimeo projects and upload quota become available

The integration connects at the organization level. All team members with appropriate roles can upload to the connected Vimeo account.

Project Creation

preroll.io organizes videos within Vimeo projects (folders):

• Each show maps to a Vimeo project
• Episodes are uploaded as videos within the show's project
• Projects are created automatically on first upload, or you can link to an existing Vimeo project

Vimeo Account/
├── The Morning Show (Project)
│   ├── EP001 - Pilot
│   ├── EP002 - The Interview
│   └── EP003 - Season Finale
└── Tech Talks (Project)
    └── EP001 - AI in Podcasting

Upload Protocol

preroll.io uses the tus resumable upload protocol for reliable video uploads to Vimeo:

• Supports files of any size (tested up to 10 GB+)
• Automatic resume on network interruption
• Chunk-based upload with progress tracking
• Background upload — continue working while files transfer

Upload Flow

1. preroll.io creates a video resource on Vimeo with metadata
2. A tus upload URI is returned
3. The file is uploaded in chunks (default 128 MB per chunk)
4. Vimeo processes the video (transcoding, thumbnail generation)
5. preroll.io receives a webhook when processing completes

# Under the hood, the tus upload looks like:
PATCH /upload?upload_id=xyz
Tus-Resumable: 1.0.0
Upload-Offset: 0
Content-Type: application/offset+octet-stream

Generating Review Links

Once a video is uploaded and processed, preroll.io can generate private review links:

Review links are automatically attached to the corresponding deliverable in preroll.io.

Embedding Videos

Videos hosted on Vimeo can be embedded directly in the preroll.io client portal:

• Private videos are accessible via domain-restricted embeds
• No Vimeo account required for clients to view
• Responsive player adapts to any screen size
• Playback analytics are available in your Vimeo dashboard

Embed Configuration

{
  "privacy": "disable",
  "embed": {
    "domains": ["your-domain.com"],
    "buttons": {
      "share": false,
      "embed": false
    }
  }
}

Troubleshooting