Skip to main content

Web Hooks

Programmatic listening to video status change events​

Date: 2018-09-30

Three actions are supported using web hooks:

  1. List all hooks
  2. Create new hook
  3. Delete a hook

Read on authorization for more details on the authorization header in the above request

  • Supported events: video:ready and video:readyall
  • Supported types: http

Webhook HTTP request information:

  • Method: POST
  • Content-type: application/json
  • Sample body:
hookId: '5d56a5234f99xxxxxxxxxxxxxxxxxxxx',
event: 'video:ready',
time: 1538330269833,
payload: {
id: '8cf4129200a4xxxxxxxxxxxxxxxxxxxx',
title: 'The Daily Dweebs.mp4',
upload_time: 1538329973,
tags: null,
length: 60,
status: 'ready'

Sample CURL statements​

  1. List all hooks
curl -i -H 'authorization: Apisecret __________' -H 'content-type: application/json'
  1. Create new hook
curl -i -X POST -H 'authorization: Apisecret __________' -H 'content-type: application/json'  -d '{"type": "http", "value": "","event": "video:ready", "status": 1}'
  1. Delete a hook
curl -i -X DELETE -H 'authorization: Apisecret __________' -H 'content-type: application/json' -d '{"uuid": "_______"}'