Vimeo
Move briefs, assets and sign-offs through Vimeo without chasing between tools.
15 ways to read, 5 ways to write, each write switched on by you.
Quality checks
Built and tested with example responses.
- Ready to connect: doneEvery listed action is built in.
- Built and tested with example responses: doneEach action is built from the provider’s published API and tested against example responses, errors, rate limits and paging.
Connected, approved, proven.
The things teams do most with Vimeo, an example flow with a person in the loop, and what Nexra keeps as proof.
Top actions
- Add video to folderApproval by rule
- Create folderApproval by rule
- List comment repliesRead
Example flow
- Vimeo · List comment repliesDone
- Vimeo · Add video to folderNeeds approval
- Nexra · Record the decision and result in the evidence chainProven
Example workflow. Routine runs go through on their own. Only a change your rules flag, such as one over a limit you set, waits for the right person, who sees the exact change and the rule before it reaches Vimeo.
What gets logged
- Whether it ran on its own or who approved it, and under which rule
- A fingerprint of the exact request sent to Vimeo
- Vimeo's reply: what it created or changed
- One entry in the evidence chain, linked to the one before
Try this in the sandbox
Run the whole flow with test data in your sandbox, then connect your own account when you are ready to go live.
For developers
Technical detail
Vimeo videos, folders, showcases, comments, captions and tags, plus video metadata updates, folders, pull-URL uploads kept private or unlisted and resumable (tus) uploads kept private (API 3.4).
Vimeo API docs- Source actions
- 15
- Destination actions
- 5
- Data types
- 12
What you can map
Reads are always available. Writes are off until you switch them on for a connection, and governed writes follow your policies.
Comment replies1
- List comment repliesSource
Replies to one video comment.
Comments1
- List video commentsSource
Top-level comments on a video.
Embed presets1
- List embed presetsSource
Saved embed (player) presets in the account.
Folder videos2
- List videos in a folderSource
Videos inside one folder.
- Add video to folderDestinationProvider duplicate protectionApproval before production
Moves a video into a folder. Repeating it leaves the video in the same folder.
Folders3
- Create folderDestinationNot retried automaticallyApproval before production
Creates a folder (Vimeo project) in the account.
- Get folderSource
One folder (Vimeo project).
- List foldersSource
Folders (Vimeo projects) in the account.
Showcase videos1
- List videos in a showcaseSource
Videos in one showcase, in showcase order by default.
Showcases2
- Get showcaseSource
One showcase (Vimeo album).
- List showcasesSource
Showcases (Vimeo albums) owned by the account.
Text tracks2
- Get text trackSource
One caption or subtitle track.
- List text tracksSource
Captions and subtitles on a video, with time-limited WebVTT links.
Video files1
- Upload video file (tus, private)DestinationNot retried automaticallyApproval before production
Creates a private (only me) video and uploads the file to it with Vimeo's resumable tus approach.
Video tags1
- List video tagsSource
Tags on a video.
Video uploads1
- Upload video from URL (pull)DestinationNot retried automaticallyApproval before production
Creates a video that Vimeo downloads from a public HTTPS URL. The video is private (only me) unless you choose unlisted.
Videos4
- Get videoSource
One video with privacy, upload and transcode status, tags and folder.
- List my videosSource
Videos the authenticated account owns, with privacy, status and tags.
- Search my videosSource
Searches the account's own videos by text.
- Update video detailsDestinationProvider duplicate protectionApproval before production
Updates a video's title, description, license or language, and optionally makes it private (only me) or unlisted.
Access and limits
- Authentication
- Vimeo personal access token (or OAuth access token)
- Plans and access
- Any Vimeo account can create an API app and personal access token. Upload limits, folders and team access depend on the Vimeo plan. The token's scopes decide what Nexra can do: public and private to read, edit to update videos, create for folders, interact to add videos to folders and upload for pull and tus uploads.
- Test environment
- Vimeo has no sandbox. Use a test Vimeo account or a test folder; uploads count against the account's storage quota.
- Rate limits
- Vimeo limits requests per app and account and reports X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. HTTP 429 is retried after Retry-After or the reset time, up to Nexra's maximum wait.
- Pagination
- page and per_page (up to 100). Responses carry paging.next, which is null on the last page.
- Provider events
- Vimeo documents webhooks for apps on eligible plans. Flows run on demand, on a schedule, or when a scheduled check finds new or changed records.
Before you build a flow
- Never deletes videos, folders, showcases, comments or text tracks, and never sets a video's privacy to anybody (public), contacts, users, disable or password. Updates and uploads accept only nobody (only me) or unlisted.
- Two upload approaches: pull (Vimeo downloads the file from a public HTTPS URL valid for at least 24 hours) and resumable tus uploads (video_files.create), where Nexra sends a file it holds or fetched in 16 MiB PATCH chunks. tus uploads are always private (nobody); a failed chunk resumes from the offset Vimeo reports and the video is never created twice. The form (POST) approach is not offered.
- Video analytics (Vimeo's Analytics API) require a Vimeo Enterprise account and account-manager approval, so they are not offered. The play count Vimeo includes on video records is mapped where present.
- Vimeo has no updatedSince filter. Sort videos by modified_time descending and stop when you reach records you have already seen.
- Showcases, comments and text tracks are read only. Comment and reply creation, likes, credits and embed settings are not offered.
Developer reference
- Create the Vimeo credentials described above with the narrowest permissions your flows need.
- In Nexra, open Connect, then Connections, then New connection, choose Vimeo, enter its settings and credentials, and tick only the write actions you need. Connection guide
- Test the connection, then use its actions as flow sources and destinations. Flow guide
Machine-readable detail: GET /api/public/connect/connectors/vimeo and the Connections API.