Learn how to integrate your Hub with Vidyard to pull in video content from your Vidyard account.
Before You Begin
- To integrate Vidyard with your Hub, you need to be an Account Admin or Content Manager.
- You will also need a Vidyard account, and your Vidyard plan must include API access. If you're not sure whether your plan includes API access, please contact your Vidyard representative for help.
About the Vidyard Integration
Vidyard is a video hosting platform specifically tailored to Marketing and Sales use cases. If you're already hosting your video content on Vidyard, you can easily make it part of your content experiences by bringing it into your Hub with our Vidyard integration.
Prerequisite: Get Your Vidyard API Token
To pull your Vidyard Players into your Hub, Uberflip will access your Vidyard account using the Vidyard API. To do that, we'll need an API token. You use API tokens to give third party services access to your Vidyard account without needing to share your login credentials.
In Vidyard, API tokens are specific to a Sub-group and the Players it contains. Vidyard controls access to a Sub-group using Roles, and each role has its own API token. You can use any default or custom role's API token with Uberflip, provided that the role has the View Organizations Assets permission enabled. If you would like to simply use a default system role's API token, choose the token belonging to the User role.
Once you have chosen the role you want to use, simply copy its API token in Vidyard.
To learn where you can find and copy the API token you'll need, see this article from Vidyard:
Create a Vidyard Stream
All you have to do to connect your Hub to Vidyard and pull in all available Players is create a new Vidyard Stream. Once you have created a Vidyard Stream, it will remain connected to your Vidyard account, and will continue to pull in any new content you publish there automatically.
Each time you create a new Vidyard Stream in your Hub, you'll be asked to enter an API token. This means you can create separate Vidyard Streams with different API tokens, for example if you need to import Players from multiple Vidyard Sub-groups.
Note: Vidyard Player and Video Structure
Vidyard organizes video content in the following way: Parent Group > Sub-group > Player > individual videos. In other words, a Parent Group can contain multiple Sub-groups, and each Sub-group can contain multiple Players, which in turn can contain multiple videos.
Uberflip imports all Players from a specified Sub-group. Note that:
- API tokens are specific to a single Sub-group, so adding a new Stream will only import Players from the Sub-group associated with the API token you provided. You would need to add additional Streams to import Players in other Sub-groups (using separate API tokens).
- Uberflip will create one Item per Player. If a Player contains multiple videos, they will all be contained within the one Item representing that Player.
- Log in to Uberflip and navigate to the Hub where you want to add the Vidyard Stream.
- In the menu on the left, click on Content.
- You'll see the Manage Content section on the right, where the Streams tab should be selected. Here, click on the New Stream button in the grey menu bar near the top:
- The Add a Stream menu will appear. Click on the Vidyard button:
- You should now see the Add a Vidyard Stream window. Here, paste your Vidyard API token into the field provided:
- When you're ready to proceed, click on the Import button.
- Uberflip will begin importing players from the Vidyard account associated with the token. When it's done, you'll see a confirmation message that shows the number of players that were imported. To view the content Items that were created for these players, click on the View Stream button:
- That's it! Your Vidyard content has been imported into your Hub, and is now available to be included in the content experiences you create.
Does your Vidyard account contain a lot of players? By default, Vidyard Streams will pull in a maximum of 50 players. If you need to import more than that, please contact Uberflip Support for help.