A Vimeo API authentication error in WordPress means Vimeotheque cannot verify your identity with the Vimeo API. Without a valid authenticated connection, no import will succeed. This guide explains why authentication errors happen and how to resolve them so you can start importing with the Vimeotheque plugin.
What Causes a Vimeo API Authentication Error
Authentication between Vimeotheque and Vimeo requires an OAuth application registered in the Vimeo Developer portal. The plugin uses that application’s credentials to obtain an access token. Authentication fails when any step of this chain breaks.
Missing or Incorrect Client ID / Client Secret
The most common cause is that the Client ID or Client Secret has been entered incorrectly, or has not been saved after entry. Even a trailing space in one of these fields will cause authentication to fail.
Vimeo App Deleted or Revoked
If the Vimeo app associated with your credentials was deleted in the Vimeo Developer portal, or if Vimeo revoked access due to a policy issue, the credentials will no longer work. You need to create a new app and re-enter the credentials.
Insufficient App Permissions
A Vimeo app with only the public scope cannot access private videos. Attempting to import content that requires additional permissions will return an authentication or authorization error. The required scope depends on the type of content you are importing.
OAuth Not Completed for Private Access
Importing private Vimeo content requires completing an OAuth authorization flow, not just entering the Client ID and Secret. If you skip this step, imports that require private access will fail with an authentication error.
How to Fix the Vimeo API Authentication Error
Step 1: Create or Verify Your Vimeo App
Log in to the Vimeo Developer portal at developer.vimeo.com. Navigate to My Apps and confirm your app exists. If it was deleted, create a new app. Give it a descriptive name and set the app type to Personal. Under the Authentication tab, ensure the public scope is checked. Add private if you need to import private videos.
Step 2: Copy the Credentials into Vimeotheque
From the Vimeo app page, copy the Client Identifier and Client Secret exactly. Paste them into Vimeotheque → Settings → API in WordPress. Click Save Settings before doing anything else.
Step 3: Test the Connection
After saving, use the built-in connection test link on the settings page. If the test passes, basic API access is working. If it fails, re-check the credentials for extra spaces or incorrect characters.
Step 4: Authorize for Private Video Access
If you need to import private videos, click the Authorize the plugin on Vimeo link in the API settings. You will be redirected to a Vimeo consent screen. Accept the permissions to complete the OAuth handshake. After returning to WordPress, the plugin stores the access token automatically.
With authentication working, you can import Vimeo videos into WordPress individually or in bulk. The Vimeo API integration in Vimeotheque handles all subsequent API calls automatically once the initial connection is established.
Frequently Asked Questions
Do I need a paid Vimeo account to use the API?
A free Vimeo account can create a developer app and use the API for basic public video access. Importing private videos or accessing advanced API features requires a paid Vimeo plan.
How often do API tokens expire?
Standard OAuth tokens issued by Vimeo do not expire unless revoked. If you see recurring authentication errors after initial setup, check whether your Vimeo app was modified or its access was revoked in the Developer portal.
Can I use the same Vimeo app for multiple WordPress sites?
Yes. One Vimeo app can be used across multiple Vimeotheque installations. Each site will use the same Client ID and Secret, and each will need to complete the OAuth authorization flow independently.
What scopes does Vimeotheque need?
At minimum, the public scope is required to import public videos. For private videos, the private scope is needed. For importing from showcases, folders, or portfolios, Vimeotheque PRO also uses the video_files scope in some configurations.
What should I do if the connection test passes but imports still fail?
A passing connection test confirms basic API access. If imports fail, the issue is likely a per-video privacy setting or a missing permission scope for the specific content type you are trying to import.
Configure Vimeo API and start importing videos into WordPress →