Blog
How to

How to connect Vimeo to post mate (2026 guide)

YSYurii Shevchyk·Founder, Post Mate
5 min readMay 27, 2026
Vimeo · OAuth · sign in with Vimeo (paid plan required)
Vimeo on Pro, Business or Premium.

Vimeo is the only platform post mate connects to that explicitly requires a paid plan to use the API's upload endpoint. Free accounts can sign in via OAuth but cannot publish. Once you are on Vimeo Pro, Business or Premium, the connection becomes a normal scheduled-upload target.

Connect Vimeo in 5 steps

  1. Confirm a paid Vimeo plan

    Free accounts hit a permission error at upload time because the API endpoint is reserved for Pro/Business/Premium. Check your plan at vimeo.com/settings — upgrade first if needed.

  2. Open /app/connections and click "Connect Vimeo"

    post mate redirects to Vimeo's OAuth screen. Sign in with the account that owns the paid plan.

  3. Approve the scopes

    Vimeo requests public, private, upload, edit and create. upload is the critical one — it gates the videos/upload endpoint. Approve and you return to /app/connections.

  4. Optional: pick a default folder and privacy

    On the Vimeo row in /app/connections you can pin a default library folder and a default privacy level. Every new post in /app/compose pre-fills these values.

  5. Schedule a video

    Attach an MP4 or MOV in /app/compose, fill in title/description/tags, pick a privacy level. At the scheduled time post mate uses resumable upload to push the file, then patches the metadata. Processing can take a few minutes — the URL appears once Vimeo confirms.

Once you're back inside post mate the account shows up on /app/connections with a green connection dot. From there it's available as a target in every composer.

What you can post to Vimeo from post mate

  • Video upload — MP4/MOV, plan-dependent size caps.
  • Title, description, tags
  • Privacy (public, unlisted, password)
  • Folder assignment — Library folder, not a public showcase.
  • Custom thumbnail — Set after the video finishes processing.
  • ×Live streams — Live API is a separate product.
  • ×Free-plan uploads — API upload is gated to Pro+.

Vimeo API capabilities — the honest list

What works

  • Resumable video upload
  • Title, description, tags
  • Privacy levels (public, unlisted, password, disable)
  • Folder assignment
  • Custom thumbnail

What the API doesn't expose

  • Free-plan uploads
  • Live stream scheduling (separate Live API)
  • OTT/Vimeo Studio scheduling
  • Editing video file after upload (only metadata)
  • Showcase ordering via this scope

FAQs

I have a free Vimeo account — can I still connect?

The OAuth handshake succeeds, but scheduled uploads will return a permission error from Vimeo. Upgrade to Pro or higher to actually publish.

What's the upload size limit?

Depends on your plan. Pro is currently 20 GB / week, Business and Premium higher. post mate doesn't enforce — Vimeo does, and the error surfaces verbatim if you exceed it.

Why is my video still processing after the scheduled time?

Vimeo processes uploads asynchronously. The "scheduled" timestamp is when the upload starts, not when the video is viewable. 4K files can take 20+ minutes.

Does post mate store my Vimeo password?

No. OAuth tokens only. Revoke at vimeo.com/settings/apps.

Can I connect more than one Vimeo account?

Yes. One OAuth flow per account, each its own row.

Ready to schedule your first post?

Sign up for post mate, connect Vimeo from /app/connections, and start cross-posting from a single composer. 14-day free trial, cancel anytime — no credit card to start the trial when you sign up with Google.

Ready to post once, everywhere? Start a free 14-day trial — no card.

Got a question for the author?
Reply to this post on Bluesky — Yurii usually answers within a day.