Skip to content


The VdoCipher modules enable you to monitor video status, upload or import video from URL, or generate OTP in your VdoCipher account.

Getting Started With VdoCipher



The module dialog fields that are displayed in bold (in the Ibexa Connect scenario, not in this documentation article) are mandatory!

Connecting VdoCipher to Ibexa Connect

To connect your VdoCipher account to Ibexa Connect, you'll need to obtain the API secret key from your VdoCipher account, and insert it in the VdoCipher module's Create a connection dialog.

  1. Log in to your VdoCipher account.

  2. Navigate to Config > API Keys. Click Generate API Key.


  3. Copy the provided API Key.

  4. Go to Ibexa Connect, and open the VdoCipher module's Create a connection dialog.

  5. 5Enter the API Key you have copied in step 3 in the API secret key field, and click the Continue button to establish the connection.

The connection has been established. You can proceed with setting up the module.


Watch Video Status

Triggers when a video is ready or encounters an error.

Webhook name

Enter the name for the webhook, e.g., Video ready.


Select one of the options:

  • Video Ready — Returns basic details about the video.

  • Video Ready All — Returns detailed information about the video and the user.

Upload Video

Uploads video to your account.

Video Title Enter the title of the video.
Source File Map the file you want to upload from the previous module (e.g., HTTP > Get a File or Google Drive > Download a File), or enter the file name and file data manually.

Import Video from URL

Initiates video import from any HTTP/ FTP URL.


YouTube links cannot be imported.

HTTP/ FTP URL Enter the URL of the video you want to import.


Generate an OTP

Generates an OTP token for video playback.

You will need to send both OTP and Playback Info generated by this module to your website front-end as part of the embed code.

Video ID Enter the ID of the video. You can use the video title or tags to find the correct video ID.
Time-to-live in seconds Set the time-to-live in seconds. For more details, please refer to the VdoCipher ttl documentation.
URL Whitelist A string that matches the regex passed. For more details, please refer to VdoCipher URL Whitelist documentation.
Is Offline Video Enable this option, and specify the Rental duration in secondsto allow your viewers to download an encrypted version of the video to their Android devices.

Make an API Call

Allows you to perform a custom API call.


Enter a path relative to example: /videos.

For the list of available endpoints, refer to the VdoCipher API Documentation.


Select the HTTP method you want to use:


to retrieve information for an entry.


to create a new entry.


to update/replace an existing entry.


to make a partial entry update.


to delete an entry.


Enter the desired request headers. You don't have to add authorization headers; we've already added these for you.

Query String

Enter the request query string.


Enter the body content for your API call.

Example of Use - List Videos

The following API call returns all videos in your VdoCipher account:






The result can be found in the module's Output under Bundle > Body > rows.

In our example, 3 dashboards were returned: