Skip to main content

How to configure SCIM for Entra ID (formerly Azure AD)

This feature requires an Enterprise plan.

You can configure SCIM to create and manage team accounts and user groups. This article discusses how you can set up a SCIM connection with Vimeo for your organization using Microsoft Entra ID as your IdP (Identity Provider).

If you’re an existing Vimeo Enterprise customer and don’t have SCIM, please contact your Account Manager for more information. If you are not a Vimeo Enterprise customer yet and are interested in SCIM, please contact us.  

In this article:

How to prepare the Vimeo API application

  1. Open https://developer.vimeo.com
  2. Log in as a team owner.
  3. Select Get started or New app.
  4. Fill out the form, then select Create App.
  5. Scroll down to the Generate an access token section.
  6. Select Authenticated (you).
  7. Select Private, then SCIM scopes.
  8. Press Generate button.
  9. Copy or save newly generated token somewhere, such as a note-taking application.

App token page on vimeo developer page

How to configure the Entra ID App

  1. Go to your existing Vimeo application that is used for Vimeo.
  2. Go to Provisioning -> Update credentials -> Open Admin credentials.
  3. Set tenant URL as https://api.vimeo.com/scim/v2/1234567, where "1234567" is the Vimeo team owner's User ID (see Prerequisites).
  4. Set the Secret token from the section above (Preparing Vimeo API application).
  5. Select Test Connection.
  6. Save configuration.
  7. Open Mappings.
  8. Go to Provision Microsoft Entra ID Groups.
  9. Set up like on the screenshot below and Save.

Attribute mapping page within Entra ID platform

How to provision users from Entra ID to Vimeo

  1. Select Start provisioning button in the Entra ID Enterprise application. App page within Entra ID platform
  2. After that, every user you assign to the application under Users and groups will be provisioned into Vimeo.
  3. After provisioning is initiated you can check the Team Management page for those provisioned users. 

About supported user attributes for SCIM configuration

When you change a user, keep UserName and Email attributes identical. Vimeo supports the below user attributes:

  • schemas (read-only, required by SCIM specification)
  • id (read-only, required by SCIM specification)
  • Username (mutable, requires the same value for email)
  • Name (mutable)
    • name.formatted (same as givenName+familyName)
    • name.givenName
    • name.familyName
  • displayName (same as givenName+familyName)
  • Active (mutable)
  • emails (only type=work and primary=true) (mutable)
  • profileUrl (read-only)
  • locale (mutable)
  • groups (read-only, mutable from /Groups endpoint)
  • meta (read-only)

Please contact scim-support@vimeo.com if you have any issues.

Related articles