We provide the option to communicate with a web server whenever a video is done processing using webhooks.

Adding a webhook

  1. Log in to your account and click on the 'Account' link in the upper right.
  2. Click on the 'Video Settings' tab
  3. Enter your URL in the Webhook URL and click Update Video Setting.

The payload

When a video is done processing, we'll POST to your URL with a payload of JSON-encoded data about the video. Here is an example of the result:

  "created_at": "2012-12-20T00:07:54-05:00",
  "updated_at": "2012-12-20T00:07:54-05:00",
  "height": null,
  "width": null,
  "description": "An new video",
  "id": "a098d2bbd33e1c328",
  "sd_video_file_size": 0,
  "plays": 0,
  "title": "new upload.mov",
  "source_video_file_size": 0,
  "hd_video_file_size": 0,
  "embed_code": "<iframe class='sproutvideo-player' type='text/html' src='http://videos.sproutvideo.com/embed/a098d2bbd33e1c328/7ca00d6d622a8e8d?type=sd' width='630' height='354' frameborder='0'></iframe>",
  "state": "inspecting",
  "security_token": "7ca00d6d622a8e8d",
  "progress": 0,
  "tags": [],
  "duration": null,
  "password": null,
  "privacy": 2,
  "assets": {
    "videos": {
      "hd_video_url": null,
      "sd_video_url": null,
      "source_video_url": null
    "thumbnails": [],
    "poster_frames": []

This is sent as a POST as the POST body.


We recommend using RequestBin to troubleshoot WebHooks.

Section: Uploading
Last Updated: March 11, 2016